Social Fetch
Get API key
LinkedIn hub

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/organizations

2 credits per organization URL requested. Up to 50 organizations per request (100 credits max).

Try in playgroundFull API docs

About this endpoint

Entity graphs and education enrichment often land on a `/school/…` or organization-guest URL, not a clean `/company/{slug}` vanity path. The company-only route rejects those page types. You need one batch GET that accepts the broader set and returns a typed card you can upsert.

`GET /v1/linkedin/organizations` 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, `organization` carries `pageType`, id, slug, name, about, slogan, website, logo, industries, organization type, employee range, founded year, headquarters, and country when LinkedIn shows them. `metrics` can include followers, employees on LinkedIn, and alumni. Optional blocks cover locations, featured employees, similar organizations, recent posts, funding, stock info, and alumni insights.

Pricing is 2 credits per organization URL requested, up to 50 URLs per call (100 credits max). Trust `meta.creditsCharged` on the response. For a standard company-only lookup at 1 credit, prefer `GET /v1/linkedin/companies`. Person `/in/…` URLs belong on `GET /v1/linkedin/profiles`.

LinkedIn Organization API FAQ

How do I fetch a LinkedIn organization page via API?

Call `GET /v1/linkedin/organizations` 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. Full parameters are in the API docs.

How much does the LinkedIn Organization API cost?

2 credits per organization URL requested. You can send up to 50 URLs in one request (100 credits max). Always trust `meta.creditsCharged` on the response over a spreadsheet estimate.

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 /v1/linkedin/profiles`. Job `/jobs/view/…` URLs belong on the jobs routes.

LinkedIn organization vs company endpoint?

Use `GET /v1/linkedin/organizations` when you need schools, organization-guest pages, or a mixed batch of org page types (2 credits per URL, up to 50). Use `GET /v1/linkedin/companies` when you only have standard `/company/…` vanity pages and want the company-only card at 1 credit per successful request.

What fields does the LinkedIn organization response include?

When `lookupStatus` is `found`, you get organization identity fields (`pageType`, name, slug, about, website, logo, industries, headquarters, employee range), metrics (followers, employees on LinkedIn, alumni when present), and optional blocks for locations, featured employees, similar organizations, recent posts, funding, stock info, and alumni insights when LinkedIn exposes them publicly.

Can I look up multiple LinkedIn organization pages in one request?

Yes. Pass multiple `url` query values on the same `GET /v1/linkedin/organizations` 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