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.
- GET3 credits
/v1/companies/{slug}Get Company
Full company entity by universal-name slug.
- GET3 credits
/v1/companies/by-id/{id}Get Company (by id)
Company lookup by numeric LinkedIn ID (migration pending).
- GET3 credits
/v1/companies/{slug}/postsGet Company Posts
A company's organization timeline (migration pending).
- GET5 credits
/v1/companies/{slug}/employeesGet Company Employees
People who list this company as current employer.
Get company by slug
/v1/companies/{slug}3 creditsResolves through the source router. Cache hits return instantly; misses ask the extension to capture `/voyager/api/organization/companies` on a consented session.
The slug is the universalName — the tail of
linkedin.com/company/<slug>. Always lowercase. Cache-first;
extension fills on miss.
Get company by ID
/v1/companies/by-id/{id}3 creditsStub — 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).
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
/v1/companies/{slug}/posts3 creditsStub — returns 501. Will wrap the voyager `Company — Posts` chronFeed call.
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
/v1/companies/{slug}/employees5 creditsCache-first read. On miss, returns 422 and the extension can capture the page in one click.
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=trueto force a re-capture. - Companies that have been renamed or merged on LinkedIn surface as
301-style redirects — we follow them transparently.