# LinkedIn Post Reactions (`linkedin.post_reactions`)

People who reacted to a public LinkedIn post: reactor name, profile URL, headline and reaction type.

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

- Endpoint: `POST https://api.primaryapi.com/v1/run/linkedin.post_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.post_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 | Public LinkedIn post URL. |
| `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 |
| `items[].id` | string | Reaction id |
| `items[].postId` | string \| null | Id of the post that was reacted to |
| `items[].reactionType` | string \| null | LIKE, PRAISE, EMPATHY, APPRECIATION, INTEREST or ENTERTAINMENT |
| `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) |
| `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.post_reactions" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/posts/satyanadella_today-at-microsoft-build-activity-7329207003942125568-xyz","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",
          "postId": "string",
          "reactionType": "string",
          "actor": {
            "id": "string",
            "name": "string",
            "linkedinUrl": "https://example.com",
            "position": "string",
            "pictureUrl": "https://example.com"
          }
        }
      ],
      "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.post_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. Members who hide their profile can show up as anonymised entries. A post without reactions answers found=false.

## 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.

