API Reference/Endpoints
Retrieve a company profile
GET/api/linkedin/gateway/linkedin/company/{identifier}
Looks up a company page — size, industry, locations, follower count, and (where visible) internal headcount trends and funding history.
Authentication
Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.
Path parameters
FieldTypeDescription
identifier *stringThe company's public identifier (as it appears in its LinkedIn URL), numeric id, or urn.
Query parameters
FieldTypeDescription
account_id *stringA connected account's id.
Response fields
FieldTypeDescription
object"CompanyProfile"Always this value.
name / tagline / descriptionstringThe page's own text.
followers_count / employee_countnumberFollower and headcount figures.
organization_type"PUBLIC_COMPANY" | "PRIVATELY_HELD" | "SELF_EMPLOYED" | "GOVERNMENT_AGENCY" | "NON_PROFIT" | "SELF_OWNED" | "EDUCATIONAL" | "PARTNERSHIP"How the company classifies itself.
industrystring[]Industry tags.
locationsarrayOffice locations, each flagging whether it's the headquarters.
viewer_permissionsobjectWhat the connected account can do with the page — follow, message, view analytics, and so on.
insightsobjectHeadcount growth and tenure figures, only present when the account has access to LinkedIn's company insights.
Errors
·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key, or this feature isn't on the connected account's plan.·404 Not Found. No company exists for that identifier.
