# LinkedIn Profile Reactions (`linkedin.profile_reactions`)

Posts a LinkedIn member has reacted to: the reaction, its timestamp and the post it was made on with author and engagement.

Docs: https://primaryapi.com/docs/api-reference/linkedin/profile_reactions

- Endpoint: `POST https://api.primaryapi.com/v1/run/linkedin.profile_reactions`
- Category: Social · Platform: `linkedin` · Kind: list · Status: live
- Price: 4 credits per call; up to 125 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.profile_reactions`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `url` | string | yes |  | max 2048 chars | LinkedIn member profile URL (https://www.linkedin.com/in/<id>) or its public identifier. |
| `limit` | integer | no | 100 | 1–100 | Maximum reactions to return (1-100, default 100). Pass nextCursor for more. |
| `cursor` | string | no |  |  | Opaque pagination cursor: pass the previous response's nextCursor. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `items` | object[] | Reactions by the member, newest first |
| `items[].id` | string | Reaction id |
| `items[].url` | string \| null | URL of the post as reacted to |
| `items[].action` | string \| null | What the member did, e.g. "Satya Nadella likes this" (some sources give the reaction type only) |
| `items[].reactionType` | string \| null | LIKE, PRAISE, EMPATHY, APPRECIATION, INTEREST or ENTERTAINMENT, when known |
| `items[].createdUtc` | integer \| null | When the reaction was made (Unix seconds), when known |
| `items[].postId` | string \| null | Id of the post reacted to |
| `items[].actor` | object | The member who commented or reacted |
| `items[].actor.id` | string \| null | LinkedIn member id (the id inside the member URN), when known |
| `items[].actor.name` | string \| null | Display name |
| `items[].actor.linkedinUrl` | string \| null | Profile URL |
| `items[].actor.position` | string \| null | Headline shown next to the name |
| `items[].actor.pictureUrl` | string \| null | Profile photo URL (LinkedIn image links expire) |
| `items[].post` | object | The post it was made on |
| `items[].post.id` | string \| null | Post id |
| `items[].post.url` | string \| null | Post URL |
| `items[].post.text` | string \| null | Post text, when returned |
| `items[].post.authorName` | string \| null | Post author name, when returned |
| `items[].post.authorUrl` | string \| null | Post author profile or page URL, when returned |
| `items[].post.createdUtc` | integer \| null | When the post was published (Unix seconds), when returned |
| `items[].post.likes` | integer \| null | Post likes, when returned |
| `items[].post.comments` | integer \| null | Post comments, when returned |
| `items[].post.shares` | integer \| null | Post shares, when returned |
| `totalResults` | integer \| null | Total results LinkedIn reports for this list, when known |
| `nextCursor` | string \| null | Pass as cursor (with the same url) for the next reactions |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

Pagination: pass the previous response’s `nextCursor` as `cursor` to get the next page; `nextCursor: null` means there are no more results.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/linkedin.profile_reactions" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/in/satyanadella","limit":50}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "items": [
        {
          "id": "string",
          "url": "https://www.linkedin.com/in/satyanadella",
          "action": "string",
          "reactionType": "string",
          "createdUtc": 0,
          "postId": "string",
          "actor": {
            "id": "string",
            "name": "string",
            "linkedinUrl": "https://example.com",
            "position": "string",
            "pictureUrl": "https://example.com"
          },
          "post": {
            "id": "string",
            "url": "https://www.linkedin.com/in/satyanadella",
            "text": "string",
            "authorName": "string",
            "authorUrl": "https://example.com",
            "createdUtc": 0,
            "likes": 0,
            "comments": 0,
            "shares": 0
          }
        }
      ],
      "totalResults": 0,
      "nextCursor": null
    }
  },
  "provider": "PrimaryAPI",
  "credits": 4,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 4 credits per call
- Price ceiling: up to 125 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.profile_reactions`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Up to 100 reactions per call; pass nextCursor (with the same url) for more. Post text, author and engagement are filled when returned; otherwise the post is identified by id and URL (call linkedin.post for the rest). Reaction times are not shown by LinkedIn and stay null.

## Legal

Public LinkedIn data only. LinkedIn’s User Agreement restricts automated collection and LinkedIn enforces it; use the data for lawful purposes, keep copies only as long as you need them, and treat post and article text as the author’s content (analysis, not republication). Results contain personal data about identifiable people (GDPR, UK GDPR, CCPA): have a lawful basis, honour deletion requests, and never use it for spam or unsolicited bulk outreach.

