> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/linkedin/organizations>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/linkedin/organizations.mdx>

---

# 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 /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.

## Request

- **Endpoint:** `GET /v1/linkedin/organizations`
- **Credits:** Up to 9 credits per completed organization URL
Up to 50 organizations per request
Max 450 credits
Technical failures are free
- **Input:** by organization URL(s)
- **Platform page:** [/platforms/linkedin](https://www.socialfetch.dev/platforms/linkedin)

## 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.