# Person Social Activities

These endpoints let you explore and retrieve a person’s **public activity**: posts they authored, comments they wrote, reactions they gave, and full details for a specific post (including its comments, reactions, and reposts). Use them to power **sales intel**, **recruiting research**, **influencer mapping**, and **engagement analytics**.

***

### 1) Posts

List recent **posts authored** by a person identified by a Social URL (or by a previously resolved person ID).

| Aspect       | Description                                                                                    |
| ------------ | ---------------------------------------------------------------------------------------------- |
| **Purpose**  | Discover a person’s recent authored content (thought leadership, announcements, hiring notes). |
| **Input**    | Person **Social URL** or **personId**; optional **pagination** and **time window**.            |
| **Output**   | A **list of post objects** plus **pagination metadata**.                                       |
| **Credits**  | Typically **1 credit per call/page** (align with your billing policy).                         |
| **Best for** | Sales/recruiting research, content relevance, engagement scoring.                              |

#### Objects Structure

* `activityId` — unique identifier of the post
* `text` — post content
* `reactionsCount`, `commentsCount` — engagement counters
* `activityDate` — timestamp of the post
* `author` — object with `authorId`, `authorName`, `authorPublicIdentifier`, `authorHeadline`, `authorImage`, `authorUrl`
* `activityUrl` — Social URL of the post
* `shareUrl` — share link

***

### 2) Comments

List recent **comments authored** by the person across various posts.

| Aspect       | Description                                                                 |
| ------------ | --------------------------------------------------------------------------- |
| **Purpose**  | Understand **where and how** the person engages (topics, people, brands).   |
| **Input**    | Person **Social URL** or **personId**; optional **pagination/time window**. |
| **Output**   | A **list of comment objects** with references to the **parent post**.       |
| **Credits**  | Typically **1 credit per call/page**.                                       |
| **Best for** | Interest mapping, influencer analysis, competitor monitoring.               |

#### Objects Structure

* `text` — comment text
* `reactionsCount` — reactions to this comment
* `commentsCount` — replies under this comment
* `activityDate` — timestamp of the comment
* `author` — block with `authorId`, `authorName`, `authorPublicIdentifier`
* `activityUrl` — Social URL to the comment
* `relatedPost` — object of the parent post (`activityId`, `text`, etc.)

***

### 3) Reactions

List recent **reactions** (likes, celebrates, etc.) made by the person on other posts.

| Aspect       | Description                                                                  |
| ------------ | ---------------------------------------------------------------------------- |
| **Purpose**  | Reveal the person’s **interests and affinities** via their reaction history. |
| **Input**    | Person **Social URL** or **personId**; optional **pagination/time window**.  |
| **Output**   | A **list of reaction objects** tied to **post references**.                  |
| **Credits**  | Typically **1 credit per call/page**.                                        |
| **Best for** | Interest graph building, ABM signal scoring, prospect research.              |

#### 🧩 Objects Structure

* `reactionId` — unique ID
* `type` — reaction type (like, celebrate, insightful, etc.)
* `createdAt` — timestamp of the reaction
* `post` — block with `activityId`, `text`, `author`, `activityUrl`

***

### 4) Post Details

Retrieve the **full details of a single post** using its ID or Social URL.

| Aspect       | Description                                                                    |
| ------------ | ------------------------------------------------------------------------------ |
| **Purpose**  | Access complete content and engagement stats of a single post.                 |
| **Input**    | `activityId` or `activityUrl` — required.                                      |
| **Output**   | A **post object** with full details.                                           |
| **Credits**  | 1 credit per call.                                                             |
| **Best for** | Post analytics, storing/archiving, connecting with comments/reactions/reposts. |

***

### 5) Post Comments

Retrieve the **comments under a specific post**.

| Aspect       | Description                                     |
| ------------ | ----------------------------------------------- |
| **Purpose**  | Explore the audience’s replies under a post.    |
| **Input**    | `activityId` or `activityUrl` — required.       |
| **Output**   | A list of **comment objects** tied to the post. |
| **Credits**  | 1 credit per call (per page).                   |
| **Best for** | Engagement analytics, sentiment research.       |

***

### 6) Post Reactions

Retrieve the **reactions on a specific post**, including reaction type and (when available) the reacting users.

| Aspect       | Description                                               |
| ------------ | --------------------------------------------------------- |
| **Purpose**  | Understand who engaged with a post and how.               |
| **Input**    | `activityId` or `activityUrl` — required.                 |
| **Output**   | A list of **reaction objects** (user + type + timestamp). |
| **Credits**  | 1 credit per call (per page).                             |
| **Best for** | Audience mapping, ABM signal scoring, influencer prep.    |

***

### 7) Post Reposts

Retrieve the **reposts (shares)** of a post, including who reshared it and when.

| Aspect       | Description                                                           |
| ------------ | --------------------------------------------------------------------- |
| **Purpose**  | Measure amplification and reach through reshares.                     |
| **Input**    | `activityId` or `activityUrl` — required.                             |
| **Output**   | A list of **repost objects** (reposter + date + optional commentary). |
| **Credits**  | 1 credit per call (per page).                                         |
| **Best for** | Virality analysis, campaign measurement, influencer tracking.         |

{% hint style="warning" %}
**Important Notice**

This documentation is only a **preview** of our API. It provides a high-level overview of what the API can do and which types of data objects you can expect.\
\
The **official API Reference** — including full technical specifications, JSON schemas, sample results, error codes, and authentication details — is only available after signing up to our platform.\
\ <a href="https://app.scrapin.io/auth/register" class="button primary">Sign up to access the full API Reference</a>
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.scrapin.io/api/readme-5.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.