LinkedIn Organization API
Look up public LinkedIn company, school, or organization-guest pages by URL and get structured JSON — name, about, metrics, alumni counts when present — without scraping HTML yourself.
GET /v1/linkedin/organizationsUp to 9 credits per completed organization URL Up to 50 organizations per request Max 450 credits Technical failures are free
About this endpoint
GET /v2/linkedin/organizations/batch takes one or more public organization page URLs (url query param, repeatable). Accepted paths include /company/…, /school/…, and /organization-guest/company/…. Each result has lookupStatus — write when it is found, keep requestId when it is not. When found, the core organization projection carries page type, id, slug, name, about, website, logo, industries, organization type, employee range, founded year, headquarters and country when supplied. Metrics can include followers and employees on LinkedIn, and locations are included when supplied. Legacy featured employees, similar/affiliated organizations, recent posts, funding, stock and alumni blocks are not returned by this core lookup; the v2 organization section routes expose supported extras separately.
Each URL runs a 3-credit slug resolution stage, then a 6-credit core lookup after a successful resolution. A found organization costs up to 9 credits; a verified resolver miss costs 3. Technical failures and unstarted work cost zero. Up to 50 URLs can require 450 credits of authorization. Trust meta.creditsCharged. Live data can be served within a documented freshness window, including cache hits.
LinkedIn Organization API FAQ
How do I fetch a LinkedIn organization page via API?
Call GET /v2/linkedin/organizations/batch with your Social Fetch API key (x-api-key) and one or more public organization url query params (for example https://www.linkedin.com/school/uxdesigninstitute/). Read data.results[].lookupStatus and the organization object in the JSON response. See the API docs for parameters.
How much does the LinkedIn Organization API cost?
Up to 9 credits per completed URL: 3 for slug resolution, plus 6 when resolution succeeds and the core organization lookup runs. A verified resolver miss costs 3. Up to 50 URLs require 450 credits of maximum authorization. Trust meta.creditsCharged.
What URL formats does the LinkedIn organization endpoint accept?
Pass a public LinkedIn organization page URL with a /company/, /school/, or /organization-guest/company/ path. Person /in/… URLs belong on GET /v2/linkedin/profiles. Job /jobs/view/… URLs belong on GET /v2/linkedin/jobs/{jobId} or GET /v2/linkedin/jobs/batch.
LinkedIn organization vs company endpoint?
Use GET /v2/linkedin/organizations/batch when you need schools, organization-guest pages, or a mixed batch of org page types (up to 9 credits per completed URL). Use GET /v1/linkedin/companies when you only have standard /company/… vanity pages.
What fields does the LinkedIn organization response include?
When lookupStatus is found, you get core organization identity fields (pageType, id, name, slug, about, website, logo, industries, headquarters and employee range), follower/employee metrics, and locations when supplied. Use the v2 section routes for supported headcount, similar, affiliated, posts and jobs extras.
Can I look up multiple LinkedIn organization pages in one request?
Yes. Pass multiple url query values on the same GET /v2/linkedin/organizations/batch call, up to 50. The response returns a results array plus a summary of found, not_found, and errored counts.
What happens when a LinkedIn organization URL is not found?
The batch still returns HTTP 200 with per-URL rows. Check each result's lookupStatus. Only upsert when status is found. Keep meta.requestId (and any per-row error) so you can retry or escalate failed enrichment rows.
Other LinkedIn endpoints
- ProfileGET /v2/linkedin/profiles
- ProfilesGET /v2/linkedin/profiles/batch
- Resolve personGET /v2/linkedin/people/resolve
- Profile postsGET /v2/linkedin/people/{entityId}/posts
- Profile commentsGET /v2/linkedin/people/{entityId}/comments
- Employment historyGET /v2/linkedin/people/{entityId}/employment-history
- RecommendationsGET /v2/linkedin/people/{entityId}/recommendations
- InterestsGET /v2/linkedin/people/{entityId}/interests