LinkedIn API reference
Public LinkedIn people, organizations, jobs, posts, and search over REST — one API key, no LinkedIn partner app or member login.
Social Fetch's LinkedIn tag is a set of GET /v2/linkedin/... routes. Pass a handle, entity ID, organization ID, job ID, URL, or search query and get { data, meta } with meta.requestId and meta.creditsCharged. Authenticate with x-api-key only — no LinkedIn partner app or member login.
These pages are generated from the public OpenAPI spec. Product overview, examples, and FAQs live on the LinkedIn scraper API hub. Older /v1/linkedin integrations: v1 to v2 migration.
Credits
Most LinkedIn v2 routes are 3 credits per completed lookup, and paginated calls bill each page. Exceptions: a single organization by numeric ID is 6, organization resolve is 3 (including a verified miss), organization URL batches are up to 9 per completed URL, and job search is 6 per page. Person and job URL batches are 3 per completed URL. Trust meta.creditsCharged.
Identifiers
These IDs are not interchangeable. Treat every ID as a string.
| You have | Use this field | Shape |
|---|---|---|
linkedin.com/in/jane-doe | handle = jane-doe | Public slug |
| A prior person lookup | entityId | Opaque, often ACo… |
linkedin.com/company/stripe | slug = stripe, then resolve | Public slug |
| Company or school page ID | id or organizationId | Digits, as a string |
linkedin.com/jobs/view/4468687278 | jobId | Digits, as a string |
| A post from a feed | activityId | Digits; urn:li:activity:… is stripped |
entityId is the stable person token — not the vanity handle, and not an organization or job ID. Read it from GET /v2/linkedin/profiles (data.profile.entityId) or GET /v2/linkedin/people/resolve (data.identity.entityId). People-section routes require it in the path. On the profile route, send handle or entityId, not both.
Resolve a company slug with GET /v2/linkedin/organizations/resolve before organization section routes.
Profiles and people
LinkedIn profile
`GET /v2/linkedin/profiles` — one person by handle or entity ID.
Profile batch
`GET /v2/linkedin/profiles/batch` — up to 50 profile URLs.
Resolve person
`GET /v2/linkedin/people/resolve` — handle to entity ID.
Profile posts
`GET /v2/linkedin/people/{entityId}/posts` — that person's feed.
Profile comments
`GET /v2/linkedin/people/{entityId}/comments` — comments they wrote.
Employment history
`GET /v2/linkedin/people/{entityId}/employment-history` — roles grouped by organization.
Recommendations
`GET /v2/linkedin/people/{entityId}/recommendations` — recommendations written for them.
Interests
`GET /v2/linkedin/people/{entityId}/interests` — followed companies, newsletters, and people.
Similar people
`GET /v2/linkedin/people/{entityId}/similar` — similar public profiles.
Organizations
Organization
`GET /v2/linkedin/organizations` — one page by numeric ID.
Organization batch
`GET /v2/linkedin/organizations/batch` — up to 50 organization URLs.
Resolve organization
`GET /v2/linkedin/organizations/resolve` — slug to numeric ID.
Organization posts
`GET /v2/linkedin/organizations/{organizationId}/posts` — company or school feed.
Organization jobs
`GET /v2/linkedin/organizations/jobs` — open jobs for one or more org IDs.
Headcount
`GET /v2/linkedin/organizations/{organizationId}/headcount` — employee-count signal.
Affiliated organizations
`GET /v2/linkedin/organizations/{organizationId}/affiliated` — related pages.
Similar organizations
`GET /v2/linkedin/organizations/{organizationId}/similar` — similar pages.
Jobs
Job
`GET /v2/linkedin/jobs/{jobId}` — one posting by numeric ID.
Job batch
`GET /v2/linkedin/jobs/batch` — up to 50 job URLs.
Hiring team
`GET /v2/linkedin/jobs/{jobId}/hiring-team` — listed recruiters and hiring managers.
Related jobs
`GET /v2/linkedin/jobs/{jobId}/related-views` — jobs people also view.
Similar jobs
`GET /v2/linkedin/jobs/{jobId}/similar` — similar postings.
Activities
Activity
`GET /v2/linkedin/activities/{activityId}` — one post or share.
Activity comments
`GET /v2/linkedin/activities/{activityId}/comments` — replies on that post.
Activity reactions
`GET /v2/linkedin/activities/{activityId}/reactions` — who reacted.
Search
Search people
`GET /v2/linkedin/people/search` — people by keyword.
Search organizations
`GET /v2/linkedin/organizations/search` — companies and schools by keyword.
Search jobs
`GET /v2/linkedin/jobs/search` — jobs by keyword.
Related
- LinkedIn scraper API hub — coverage, FAQs, and credit notes
- How to scrape LinkedIn data
- LinkedIn v1 to v2 migration
- Best LinkedIn data APIs
- Free LinkedIn profile viewer
- API reference — all platforms