API reference

LinkedIn Post Reactions API

Who reacted to a post and how, up to ten records per response: reaction type, name, headline and profile. Totals are source-reported and may include unavailable reactions. Continue with the complete returned cursor and the same post. A newly acquired source page costs eight credits; saved continuation pages marked next_page_credits=0 are free and expire after one hour. Source coverage depends on the supplied post identifier.

Endpoint

GET/v1/linkedin/post-reactionslive · proven8 credits
Try in Playground

Parameters

Query parameters

Useful optional inputs

  • pages — Bound source-page collection using this endpoint’s documented limits.

    Read the existing page budget and inspect the quote; fewer pages may fit.

  • fit — Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context.

    No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.

  • dry_run — Read a free estimate before fetching sources or scheduling paid work.

    Zero credits; cache status and availability are snapshots rather than guarantees.

NameRequiredDescriptionExample
urlnoPost URL (or pass reactions_urn from a profile-posts card)https://www.linkedin.com/feed/update/urn:li:activity:7496695637644828672
reactions_urnnourns.reactions from a profile-posts card
cursornoOpaque continuation from the previous response. Keep the same post and account; do not edit the token. Saved pages with next_page_credits=0 are free for one hour; a new source acquisition uses the normal endpoint price.2
pagesnoOptional bounded collection of 1–3 source pages at the normal price, within one shared spending limit and total deadline. Default 1. Inspect pages_fetched, partial and window_stop_reason: fewer pages may fit. Continue using the returned cursor with the same pages and filters. Source order is preserved; this is not an exhaustive result set.1
dry_runnoRead a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.1
judgmentsnoAdd bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable.on
labelnoSet none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable.none
label_evidencenoInclude exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable.1
excludenoOptionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable.engagement_bait
fitnoUse goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable.goal
goalnoRequired with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts.Find concrete product complaints
tokensnoOptional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it.4000

Examples

Make the request

curl
curl "https://www.monocrawl.com/v1/linkedin/post-reactions?url=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fupdate%2Furn%3Ali%3Aactivity%3A7496695637644828672" \
  -H "x-api-key: mn_your_key_here"
TypeScript
typescript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
  "https://www.monocrawl.com/v1/linkedin/post-reactions?url=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fupdate%2Furn%3Ali%3Aactivity%3A7496695637644828672",
  { headers: { "x-api-key": key } },
);
const body = await res.json();

if (!body.success) {
  // one error shape for every endpoint — see /docs/errors
  throw new Error(`${body.error.type}: ${body.error.message}`);
}

console.log(body.data, "credits left:", body.credits_remaining);
Python
python
import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/linkedin/post-reactions?url=https%3A%2F%2Fwww.linkedin.com%2Ffeed%2Fupdate%2Furn%3Ali%3Aactivity%3A7496695637644828672",
    headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
    timeout=60,
)
body = res.json()

if not body["success"]:
    # one error shape for every endpoint — see /docs/errors
    raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")

print(body["data"], "credits left:", body["credits_remaining"])

Response

Response fields and example

This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.

200 · application/json
{
  "success": true,
  "platform": "linkedin",
  "endpoint": "/v1/linkedin/post-reactions",
  "data": {
    "count": 0,
    "cursor": null,
    "dropped": 0,
    "has_more": false,
    "items": [
      {
        "actor": {
          "avatar": "https://example.com/example",
          "headline": "example",
          "id": "example",
          "name": "example",
          "url": "https://example.com/example"
        },
        "type": "example"
      }
    ],
    "page": 0,
    "post_url": "https://example.com/example",
    "total": 0
  },
  "credits_used": 8,
  "credits_remaining": 99,
  "request_id": "req_…",
  "cached": false
}

The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.

Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.

Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.

Field inside dataTypeMeaning
countnumber | nullNumber of records in this response, not lifetime or total matches.
cursorstring | nullOpaque next-page token; pass it back unchanged. Null does not prove complete history.
droppednumber | nullOptional dropped supplied by this operation. Null means unknown.
has_moreboolean | nullSource continuation indicator; null means unknown.
itemsarray | nullReturned records. Source coverage and completeness vary.
items[].actorobject | nullOptional actor supplied by this operation. Null means unknown.
items[].actor.avatarstring | nullOptional avatar supplied by this operation. Null means unknown.
items[].actor.headlinestring | nullOptional headline supplied by this operation. Null means unknown.
items[].actor.idstring | nullSource identifier. Preserve the supplied type and exact value.
items[].actor.namestring | nullOptional name supplied by this operation. Null means unknown.
items[].actor.urlstring | nullOriginal source URL when supplied.
items[].typestring | nullOptional type supplied by this operation. Null means unknown.
pagenumber | nullOptional page supplied by this operation. Null means unknown.
post_urlstring | nullOptional post url supplied by this operation. Null means unknown.
totalnumber | nullSource-reported total; null is unknown.

Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.

The example is invented and illustrates types only; zero and empty values are not claims about a real result.

Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference

First call in under a minute

150 free credits and a ready-made key the moment you sign up. No card.