LinkedIn people, company pages, posts, comments, jobs, groups, and the Ad Library through one API key
The widest surface on SocialCrawl: public member profiles broken out into every sub-resource LinkedIn renders, company pages with their posts, staff, hiring volume and workforce breakdowns, the full jobs surface with LinkedIn's own filters, group feeds, and the LinkedIn Ad Library. If you are building B2B prospecting, recruiting intelligence, or competitor tracking, this is where most of that data lives.
Base URL: /v1/linkedin/...
Three different identifiers, and they are not interchangeable. Member and post
endpoints take the page url. Company endpoints take a numeric company_id,
which is not in the company URL: resolve it once with
/v1/linkedin/company. Job and group endpoints take id and group_id,
which come from a list call. Passing a url to a company_id endpoint is a
400 before billing.
Quickstart
1. Fetch a profile
curl "https://www.socialcrawl.dev/v1/linkedin/profile?url=https://www.linkedin.com/in/williamhgates/" \
-H "x-api-key: YOUR_API_KEY"2. Fetch their content
curl "https://www.socialcrawl.dev/v1/linkedin/profile/posts?url=https://www.linkedin.com/in/williamhgates/" \
-H "x-api-key: YOUR_API_KEY"3. Read computed fields
When an endpoint supports a computed field and the required source inputs are present, the unified response includes that optional field. Depending on the endpoint, optional fields can include engagement_rate, language, content_category, and estimated_reach. See Computed fields for formulas, clamping rules, and null semantics.
People
GET /v1/linkedin/profile deliberately returns the condensed profile, the same summary LinkedIn shows above the fold. Each section below it is its own call against the same url, so you only pay for what you read.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/profile | 5 | Name, headline, location, follower and connection counts, picture | url |
GET /v1/linkedin/profile/stats | 5 | Just the follower and connection numbers | url |
GET /v1/linkedin/profile/about | 5 | Join month, plus how recently contact details and photo were touched | url |
GET /v1/linkedin/profile/contact | 5 | Websites, phone, address, WeChat, and Twitter the member exposed | url |
GET /v1/linkedin/profile/experiences | 5 | Full role history with dates, locations, and descriptions | url, page |
GET /v1/linkedin/profile/educations | 5 | Schools, degrees, fields of study, years attended | url, page |
GET /v1/linkedin/profile/skills | 5 | Listed skills with the endorsements shown against each | url, page |
GET /v1/linkedin/profile/certifications | 5 | Licences and certifications with issuer and expiry | url, page |
GET /v1/linkedin/profile/honors | 5 | Awards, with issuer, date, and description | url, page |
GET /v1/linkedin/profile/publications | 5 | Articles, papers, and books, with publisher and link | url, page |
GET /v1/linkedin/profile/volunteers | 5 | Unpaid and community roles the paid history does not cover | url, page |
GET /v1/linkedin/profile/recommendations | 5 | Written references, with type selecting received or given | url, type |
GET /v1/linkedin/profile/interests/companies | 5 | The companies the member follows | url, page |
GET /v1/linkedin/profile/interests/groups | 5 | The groups the member follows | url, page |
profile/about is the fastest way to tell a maintained profile from an abandoned one. The two interest lists are a decent proxy for a member's vendor affinities.
What a member says and does
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/profile/posts | 5 | What the member wrote | url, urn, limit |
GET /v1/linkedin/profile/reactions | 5 | What they engaged with | url, urn |
GET /v1/linkedin/profile/comments | 5 | What they said under other people's posts | url, urn |
GET /v1/linkedin/profile/images | 5 | Their feed narrowed to image posts | url, urn |
GET /v1/linkedin/profile/videos | 5 | Their feed narrowed to video posts | url, urn |
Posts, reactions, and comments are three genuinely different signals about the same person, and worth pulling separately rather than treating the feed as one thing.
These five are single-window feeds: LinkedIn serves one page and there is no second one to fetch, so they take no cursor. profile/posts accepts limit (up to 100, the provider's ceiling) at the same credit cost, which is the only depth control this surface has.
Every one of them accepts urn as an alternative to url. If you already hold the member's URN from a previous call (it is on author.ext.urn), pass it: the call then skips an internal profile lookup, which is faster and leaves more of the shared rate-limit budget for your other requests.
published_at on these feeds is derived from LinkedIn's own relative label ("15h", "5d", "2w"), not from a stored timestamp, so it is accurate to the hour, day, week, or month rather than the second. post.ext.published_at_precision tells you which, per post.
Companies
Company content is a two-step flow, because the numeric id LinkedIn indexes a company by does not appear anywhere in its public URL.
curl "https://www.socialcrawl.dev/v1/linkedin/company?url=https://www.linkedin.com/company/microsoft/" \
-H "x-api-key: YOUR_API_KEY"
curl "https://www.socialcrawl.dev/v1/linkedin/company/posts?company_id=1035" \
-H "x-api-key: YOUR_API_KEY"Hold the id. Every other company endpoint takes the same company_id, so you pay for the lookup once and reuse it.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/company | 5 | The company page, and the numeric id everything else needs | url |
GET /v1/linkedin/company/posts | 5 | That company's posts | company_id, page, sort_by |
GET /v1/linkedin/company/people | 10 | The staff directory, without a filter-id round trip | company_id, page |
GET /v1/linkedin/company/jobs | 10 | One employer's open roles, with the full job filter set | company_id, page |
GET /v1/linkedin/company/insights | 5 | Headcount broken down by location, school, job function, skill, and field | company_id |
GET /v1/linkedin/company/job-count | 5 | One number: currently open roles | company_id |
GET /v1/linkedin/company/affiliated-pages | 5 | A parent brand mapped to its regional and product pages | company_id |
GET /v1/linkedin/profile/full | 5 | The company page and its recent posts plus computed analytics, in one call | url, posts (1-100, default 25), include |
company/insights is a workforce profile without paging through employees, and company/job-count is the right shape for tracking hiring volume on a schedule. Each affiliated page has its own id you can feed back into posts and jobs.
Posts, comments and reactions
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/post | 5 | One post | url |
GET /v1/linkedin/post/comments | 5 | Who replied | url, sort_order, post_type, page |
GET /v1/linkedin/post/comments/replies | 5 | One comment thread opened up | url and comment_id |
GET /v1/linkedin/post/reposts | 5 | Who amplified it | url, cursor |
GET /v1/linkedin/post/reactions | 10 | Who reacted, with their name, headline, and reaction type | url, type, page |
GET /v1/linkedin/post/transcript | 10 | The spoken text of a video post | url |
GET /v1/linkedin/search/posts | 5 | Public posts and Pulse articles matching a keyword | query, date_posted, content_type, from_company, from_member |
A post's audience splits three ways and the prices differ, so pick the one that answers your question rather than pulling all three.
date_posted on search/posts accepts past_24h, past_week, or past_month, with underscores rather than hyphens. The endpoint reads public search results rather than LinkedIn's internal index, so treat its coverage as best effort: it is a monitoring tool, not a complete archive.
Jobs
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/search/jobs | 10 | Openings across every employer, as job ids | query, date_posted, experience_level, job_type, remote, easy_apply, sort_by |
GET /v1/linkedin/company/jobs | 10 | One employer's openings, same filter set | company_id, page |
GET /v1/linkedin/job | 5 | The complete posting text | id, include_skills |
Both searches return job ids rather than descriptions. Pass an id to job for the posting itself.
curl "https://www.socialcrawl.dev/v1/linkedin/search/jobs?query=machine%20learning%20engineer&remote=true&date_posted=past_week" \
-H "x-api-key: YOUR_API_KEY"
curl "https://www.socialcrawl.dev/v1/linkedin/job?id=$JOB_ID" \
-H "x-api-key: YOUR_API_KEY"Groups and ads
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/group | 5 | Description, member count, posting rules, public and active flags | group_id |
GET /v1/linkedin/group/posts | 5 | The group's discussion feed | group_id, page |
GET /v1/linkedin/ads/search | 5 | The LinkedIn Ad Library, paged on paginationToken | company, keyword, companyId, countries, startDate, endDate |
GET /v1/linkedin/ad | 5 | One ad in full, including creative images and total impressions | url |
group_id is not in the group URL. You get one from profile/interests/groups on a member who belongs to it. countries is a comma-separated list, and ad takes a result's Ad Library URL.
Turning names into filter ids
LinkedIn's people and job search filter on internal ids, not on text. Three cheap resolvers exist for exactly that.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/linkedin/search/location | 1 | A city or country name as a geocode id | query |
GET /v1/linkedin/search/schools | 1 | A university name as a school id | query, page |
GET /v1/linkedin/search/industry | 1 | An industry name as an industry id | query |
GET /v1/linkedin/search/people | 10 | Members matching a name and those filters | query, title, current_company, past_company, school, industry, geocode_location, profile_language |
Resolve once, cache the id, and reuse it across every subsequent search. When you already know the employer, company/people lists that company's staff directly and skips the round trip.
All endpoints
μλν¬μΈνΈ 45κ°λ₯Ό μ 곡ν΄μ.
| μλν¬μΈνΈ | κ²½λ‘ | ν¬λ λ§ λ±κΈ |
|---|---|---|
| LinkedIn company profile, recent posts, and computed analytics in one call. | /v1/linkedin/profile/full | standard (5cr) |
| Resolve an industry name to a LinkedIn industry id | /v1/linkedin/search/industry | standard (1cr) |
| Resolve a location to a LinkedIn geocode id | /v1/linkedin/search/location | standard (1cr) |
| Search LinkedIn schools | /v1/linkedin/search/schools | standard (1cr) |
| Get LinkedIn ad details | /v1/linkedin/ad | advanced (5cr) |
| Search LinkedIn ads | /v1/linkedin/ads/search | advanced (5cr) |
| Get LinkedIn company page with its full About tab | /v1/linkedin/company | advanced (5cr) |
| List a company's affiliated/showcase pages | /v1/linkedin/company/affiliated-pages | advanced (5cr) |
| Get aggregate insights about a company's members | /v1/linkedin/company/insights | advanced (5cr) |
| Get a company's open job count | /v1/linkedin/company/job-count | advanced (5cr) |
| List LinkedIn company posts | /v1/linkedin/company/posts | advanced (5cr) |
| Get LinkedIn group details | /v1/linkedin/group | advanced (5cr) |
| List posts in a LinkedIn group | /v1/linkedin/group/posts | advanced (5cr) |
| Get LinkedIn job details | /v1/linkedin/job | advanced (5cr) |
| Get LinkedIn post details | /v1/linkedin/post | advanced (5cr) |
| Get LinkedIn post comments | /v1/linkedin/post/comments | advanced (5cr) |
| List replies to a LinkedIn comment | /v1/linkedin/post/comments/replies | advanced (5cr) |
| List reposts of a LinkedIn post | /v1/linkedin/post/reposts | advanced (5cr) |
| Get LinkedIn user profile | /v1/linkedin/profile | advanced (5cr) |
| Get a member's account freshness signals (NOT the profile About section) | /v1/linkedin/profile/about | advanced (5cr) |
| List a member's licenses and certifications | /v1/linkedin/profile/certifications | advanced (5cr) |
| List a member's comments | /v1/linkedin/profile/comments | advanced (5cr) |
| Get a member's public contact info | /v1/linkedin/profile/contact | advanced (5cr) |
| List a member's education history | /v1/linkedin/profile/educations | advanced (5cr) |
| List a member's work experiences | /v1/linkedin/profile/experiences | advanced (5cr) |
| List a member's honors and awards | /v1/linkedin/profile/honors | advanced (5cr) |
| List a member's image posts | /v1/linkedin/profile/images | advanced (5cr) |
| List companies a member follows | /v1/linkedin/profile/interests/companies | advanced (5cr) |
| List groups a member follows | /v1/linkedin/profile/interests/groups | advanced (5cr) |
| List a LinkedIn member's posts | /v1/linkedin/profile/posts | advanced (5cr) |
| Walk a LinkedIn member's COMPLETE post history, 100 posts a page, with exact publish times and share counts the other lanes cannot return. Metered: 5 credits per post returned, so try the cheaper /v1/linkedin/profile/posts first | /v1/linkedin/profile/posts/archive | advanced (5-500cr)metered |
| List a member's publications | /v1/linkedin/profile/publications | advanced (5cr) |
| List posts a LinkedIn member reacted to | /v1/linkedin/profile/reactions | advanced (5cr) |
| List recommendations for a member | /v1/linkedin/profile/recommendations | advanced (5cr) |
| List a member's skills | /v1/linkedin/profile/skills | advanced (5cr) |
| Get a member's follower + connection counts | /v1/linkedin/profile/stats | advanced (5cr) |
| List a member's video posts | /v1/linkedin/profile/videos | advanced (5cr) |
| List a member's volunteer experiences | /v1/linkedin/profile/volunteers | advanced (5cr) |
| Search public LinkedIn posts by keyword | /v1/linkedin/search/posts | advanced (5cr) |
| List a company's job postings | /v1/linkedin/company/jobs | premium (10cr) |
| List people at a LinkedIn company | /v1/linkedin/company/people | premium (10cr) |
| List reactors on a LinkedIn post | /v1/linkedin/post/reactions | premium (10cr) |
| Get a LinkedIn post video transcript | /v1/linkedin/post/transcript | premium (10cr) |
| Search LinkedIn jobs | /v1/linkedin/search/jobs | premium (10cr) |
| Search LinkedIn people | /v1/linkedin/search/people | premium (10cr) |
Platform notes
LinkedIn has no 1-credit content surface. Every profile, post, and company read is 5 credits, and people search, company staff, company jobs, job search, post reactions, and video transcripts are 10. Only the three id resolvers above are 1 credit. Budget accordingly, and prefer the sub-resource that answers your question over pulling the whole profile family.
Sub-resources are per-person calls, not a bundle. Thirteen profile sub-resources each take the same profile url. Pulling a complete dossier on one member is thirteen billed calls, so decide up front which sections your model actually reads.
Most contact fields are empty. profile/contact returns what the member chose to publish, which for the large majority is nothing. No email address is returned by any endpoint on this platform.
Freshness values are relative text. profile/about reports strings such as Updated over 1 year ago rather than dates, because that is what LinkedIn renders. Parse accordingly, and do not expect to sort on them precisely.
post/transcript is only charged when a transcript comes back. A video with none returns transcript: null with transcriptNotAvailable: true, at no cost.
Pagination style varies by endpoint. Page-paginated endpoints start at page=1; cursor-paginated ones return a cursor to pass back. ads/search uses paginationToken instead of either.
Next steps
Pagination
Cursor and page walks, and what has_more actually means.
Credits
What each tier costs and when a call is refunded.
API reference
Every parameter and response field, endpoint by endpoint.
The other full ad library, plus pages, groups, and events.
Where B2B buyers say what they will not say on LinkedIn.
