Companies

Typed company records, headcount trends, and employee expansions.

The Companies surface resolves a LinkedIn company slug or numeric ID into a structured Company record — industry, headcount band, HQ, locations, follower count, last-funding signals where available. Pair with the employees endpoint for ICP company-list expansion.

Get company by slug

GET/v1/companies/{slug}3 credits
Get Company
Full company entity by universal-name slug.

Resolves through the source router. Cache hits return instantly; misses ask the extension to capture `/voyager/api/organization/companies` on a consented session.

parameters
This endpoint resolves through the Chrome extension when the row isn't cached. Open it in the full playground to capture via extension.

The slug is the universalName — the tail of linkedin.com/company/<slug>. Always lowercase. Cache-first; extension fills on miss.

Get company by ID

GET/v1/companies/by-id/{id}3 credits
Get Company (by id)
Company lookup by numeric LinkedIn ID (migration pending).

Stub — returns 501. Mirrors `GET /v1/companies/:slug` but addressed by numeric ID (useful when you only have the ID from People search or Company Posts).

parameters
This endpoint resolves through the Chrome extension when the row isn't cached. Open it in the full playground to capture via extension.

Resolves by numeric LinkedIn company ID. Useful when you only have the ID from a People search (currentCompany) or a Company Posts actorUrn and the slug is stale, renamed, or unstable.

Posts by company

GET/v1/companies/{slug}/posts3 credits
Get Company Posts
A company's organization timeline (migration pending).

Stub — returns 501. Will wrap the voyager `Company — Posts` chronFeed call.

parameters
This endpoint resolves through the Chrome extension when the row isn't cached. Open it in the full playground to capture via extension.

The latest content from a company page. Spot product launches, hires, earnings notes, and PR pulses — every row carries the same activity ID shape as /v1/posts/:id, so you can drill in for reactor lists.

Employees at company

GET/v1/companies/{slug}/employees5 credits
Get Company Employees
People who list this company as current employer.

Cache-first read. On miss, returns 422 and the extension can capture the page in one click.

parameters
This endpoint resolves through the Chrome extension when the row isn't cached. Open it in the full playground to capture via extension.

Paginate employees with role and location filters. Pair naturally with GET /v1/search/people when you need broader filters than what this surface exposes; this endpoint is the right tool for "who works here, paged" while search is right for "who matches this ICP across companies."

LinkedIn's own people-at-company page caps visible results at ~1,000 regardless of headcount; this endpoint inherits that ceiling.

Notes

  • 3 credits per company read; 5 credits per employees page (flat, not per employee).
  • Company records cache for 14 days; pass ?fresh=true to force a re-capture.
  • Companies that have been renamed or merged on LinkedIn surface as 301-style redirects — we follow them transparently.