LinkedIn API

Five endpoints under /v1/linkedin/*. All are GET, authenticated with Authorization: Bearer sk_live_..., and return the standard { data, meta?, request_id } envelope. LinkedIn data is premium-priced, covers public pages and posts only, and profile responses are retained in cache for at most 30 days. Transcript and summary endpoints for LinkedIn video are planned for v2.

`GET /v1/linkedin/stats`

Reactions, comments and reposts for a LinkedIn post.

Credits: 5 per post · Caching: Age-aware cache (15 min - 7 days)

Parameters

Name		Description
`url`	required	Public LinkedIn content URL.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/linkedin/stats?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Flinkedin_hiring-activity-7181111111111111111" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "linkedin",
    "entity_id": "7181111111111111111",
    "url": "https://www.linkedin.com/posts/linkedin_hiring-activity-7181111111111111111",
    "author": {
      "handle": "linkedin",
      "name": "Example Creator"
    },
    "posted_at": "2026-06-30T14:05:00Z",
    "metrics": {
      "views": 1204593,
      "likes": 88410,
      "comments": 2314,
      "shares": 10092
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/linkedin/comments`

Paginated comments on a LinkedIn post; charged per comment returned.

Credits: 5 per comment · Caching: Age-aware cache (15 min - 7 days) · Paginated (cursor/limit)

Parameters

Name		Description
`url`	required	Public LinkedIn content URL.
`limit`	optional	Items per page (default 20, max 50 sync; larger via async jobs).
`cursor`	optional	Opaque cursor from the previous page's meta.cursor.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/linkedin/comments?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Flinkedin_hiring-activity-7181111111111111111" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "c_9021",
      "text": "This fixed it for me, thank you",
      "author": {
        "handle": "dev.casey"
      },
      "likes": 412,
      "posted_at": "2026-07-01T09:12:00Z"
    },
    {
      "id": "c_9022",
      "text": "Can you do a follow-up on the advanced settings?",
      "author": {
        "handle": "mariana.codes"
      },
      "likes": 96,
      "posted_at": "2026-07-01T10:44:00Z"
    }
  ],
  "meta": {
    "count": 2,
    "limit": 50,
    "cursor": "eyJvZmZzZXQiOjUwfQ",
    "has_more": true
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/linkedin/profile`

Public profile data for a LinkedIn member: headline, positions, education.

Credits: 10 per profile (25 with include_email=true) · Caching: Cached 12 hours

Parameters

Name		Description
`url \| handle`	one required	Public LinkedIn URL, or the handle.
`include_email`	optional	true adds public contact enrichment (25 credits total).
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Flinkedin_hiring-activity-7181111111111111111" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "linkedin",
    "handle": "example-person",
    "name": "Example Person",
    "headline": "Head of Growth at Example Co",
    "location": "Austin, Texas, United States",
    "positions": [
      {
        "title": "Head of Growth",
        "company": "Example Co",
        "start": "2024-03",
        "end": null
      }
    ],
    "metrics": {
      "followers": 18240,
      "connections": "500+"
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/linkedin/company`

Company page data: industry, size, followers and description.

Credits: 10 per company · Caching: Cached 12 hours

Parameters

Name		Description
`url \| handle`	one required	Public LinkedIn URL, or the handle.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/linkedin/company?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Flinkedin_hiring-activity-7181111111111111111" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": {
    "platform": "linkedin",
    "handle": "example-co",
    "name": "Example Co",
    "industry": "Software Development",
    "employees_range": "201-500",
    "headquarters": "Austin, Texas",
    "metrics": {
      "followers": 96210
    }
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

`GET /v1/linkedin/company-posts`

Latest posts from a LinkedIn company page with per-post metrics.

Credits: 5 per post · Caching: Cached 3 hours (page 1: 1 hour) · Paginated (cursor/limit)

Parameters

Name		Description
`url \| handle`	one required	Public LinkedIn URL, or the handle.
`limit`	optional	Items per page (default 20, max 50 sync; larger via async jobs).
`cursor`	optional	Opaque cursor from the previous page's meta.cursor.
`fresh`	optional	true bypasses the cache at the same credit price.
`format`	optional	json (default), csv or text where applicable.

Request

curl "https://api.scrapersocial.com/v1/linkedin/company-posts?url=https%3A%2F%2Fwww.linkedin.com%2Fposts%2Flinkedin_hiring-activity-7181111111111111111" \
  -H "Authorization: Bearer sk_live_..."

Response

{
  "data": [
    {
      "id": "7181111111111111111",
      "url": "https://www.linkedin.com/posts/linkedin_hiring-activity-7181111111111111111",
      "text": "We are hiring across engineering and support.",
      "posted_at": "2026-07-04T11:00:00Z",
      "metrics": {
        "reactions": 842,
        "comments": 63,
        "reposts": 41
      }
    },
    {
      "id": "71811111111111111111",
      "url": "https://www.linkedin.com/posts/linkedin_hiring-activity-7181111111111111111",
      "text": "We are hiring across engineering and support.",
      "posted_at": "2026-07-04T11:00:00Z",
      "metrics": {
        "reactions": 842,
        "comments": 63,
        "reposts": 41
      }
    }
  ],
  "meta": {
    "count": 2,
    "limit": 20,
    "cursor": "eyJwYWdlIjoyfQ",
    "has_more": true,
    "item": "post"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}