LinkedIn Company API
Resolve a company page to structured firmographics — industry, employee count and range, headquarters, locations, founding year, specialities, website and follower count — in a single call.
Example response
Generated from the live API, so it is exactly the shape your code will parse.
{
"element": {
"id": "1441",
"universalName": "google",
"linkedinUrl": "https://www.linkedin.com/company/google",
"name": "Google",
"website": "https://www.google.com",
"logo": "https://media.licdn.com/dms/image/v2/sample/williamhgates.jpg",
"employeeCount": 312461,
"employeeCountRange": {
"start": 100,
"end": null
},
"followerCount": 36284119,
"description": "Organising the world’s information. Founded in 1998.",
"companyType": "Google",
"locations": [
{
"country": "US",
"city": "Seattle",
"geographicArea": "Google",
"line1": "Google",
"line2": null,
"postalCode": "Google",
"headquarter": true,
"description": null,
"parsed": {
"text": "Seattle, Washington, United States",
"countryCode": "us",
"regionCode": null,
"country": "US",
"countryFull": "United States",
"state": "Washington",
"city": "Seattle"
}
}
],
"specialities": [
"Google"
],
"industries": [
{
"id": "1441",
"name": "Google",
"urn": "1441",
"title": "Co-chair at Bill & Melinda Gates Foundation",
"hierarchy": "Google"
}
],
"logos": [
{
"url": "https://www.linkedin.com/company/google",
"width": 100,
"height": 100
}
],
"backgroundCover": "Google",
"backgroundCovers": [
{
"url": "https://www.linkedin.com/company/google",
"width": 100,
"height": 100
}
],
"active": true,
"jobSearchUrl": "https://www.linkedin.com/in/williamhgates",
"pageVerified": true,
"pageType": "Google",
"showcase": true,
"paidCompany": true,
"autoGenerated": true,
"callToActionUrl": "https://www.linkedin.com/in/williamhgates",
"similarOrganizations": [
{
"id": "1441",
"universalName": "google",
"linkedinUrl": "https://www.linkedin.com/company/google",
"name": "Google",
"website": null,
"logo": "https://media.licdn.com/dms/image/v2/sample/williamhgates.jpg",
"employeeCountRange": {
"start": 100,
"end": 100
},
"followerCount": 36284119,
"description": "Organising the world’s information. Founded in 1998.",
"industries": [
{
"id": "1441",
"name": "Google",
"urn": "1441",
"title": "Co-chair at Bill & Melinda Gates Foundation",
"hierarchy": "Google"
}
],
"backgroundCover": "Google",
"callToActionUrl": null,
"affiliatedPages": []
}
],
"affiliatedPages": [
{
"id": "1441",
"universalName": "google",
"linkedinUrl": "https://www.linkedin.com/company/google",
"name": "Google",
"website": null,
"logo": "https://media.licdn.com/dms/image/v2/sample/williamhgates.jpg",
"followerCount": 36284119,
"description": "Organising the world’s information. Founded in 1998.",
"industries": [
{
"id": "1441",
"name": "Google",
"urn": "1441",
"title": "Co-chair at Bill & Melinda Gates Foundation",
"hierarchy": "Google"
}
],
"logos": [
{
"url": "https://www.linkedin.com/company/google",
"width": 100,
"height": 100
}
],
"showcase": true,
"paidCompany": true
}
],
"peopleStats": []
},
"query": {
"universalName": "google",
"searchQuery": {
"companyUniversalNames": [],
"companySearches": []
}
},
"status": "ok"
}Company lookup and company search
There are two jobs here and two endpoints. company resolves one known company from a URL or its universal name — the google in linkedin.com/company/google. That is what you want for enrichment, when you already know who you are looking at.
company-search is for discovery: pass a keyword plus optional location and company-size filters and page through the matches. Search is priced per page returned, not per company, which makes broad prospecting queries much cheaper than resolving each result individually.
Firmographics that are actually useful for scoring
The fields that matter for lead scoring are the ones that move: employeeCount and its bucketed employeeCountRange, industries, specialities and followerCount. Taken together they separate a fifteen-person consultancy from a fifteen-thousand-person enterprise far more reliably than an industry code on its own.
Headquarters and locations are returned parsed as well as raw, so you can filter on country code without writing a geocoder. If you are building territory routing, that parsed country code is the field to key on.
Keeping a company table fresh
Company data moves slowly. Re-resolving every account nightly is a waste of balance; once a quarter is usually enough, with an on-demand refresh when a deal opens. A sensible pattern is a scheduled job that re-checks the oldest 1% of your table each night, which gives you complete rotation over about three months at negligible cost.
Store the company ID rather than the URL as your join key. Companies rebrand and change their vanity URL; the ID survives it.
Matching companies you already have
The hard part of company enrichment is rarely the API call — it is deciding that the "Acme Ltd" in your CRM is the same organisation as the acme-group LinkedIn page.
If you hold a website domain, that is your best signal: resolve candidates with company-search and match on the website field rather than the name. Domains are close to unique; company names are not, and legal suffixes ("Ltd", "GmbH", "Inc") differ between your records and theirs almost every time.
Where a company has separate regional pages, pick the one whose locations match your account and store that ID. Otherwise your headcount and industry will describe a different entity from the one your rep is selling to.
Never match on name alone without a human or a confidence threshold. It is the single most common source of quietly wrong firmographics.
Rate of change, and refresh budgets
Company records are the slowest-moving data here. Industry and founding year effectively never change; headquarters and specialities change rarely; headcount drifts continuously but slowly.
That makes a quarterly refresh sufficient for almost every use, and a nightly one a straightforward waste of balance.
What it costs
Prices are per request, charged from a prepaid balance. Bigger top-ups lower every row — Scale takes 55% off.
| Request | Starter | Pro (42% off) | Scale (55% off) |
|---|---|---|---|
| Company | $0.0400 | $0.0232 | $0.0180 |
| Company search page | $0.0400 | $0.0232 | $0.0180 |
Failed requests are never charged. See full pricing.
Frequently asked questions
Can I get a company's employee list from this endpoint?
Not from the company endpoint itself — it returns the company record. To list people, use the profile search endpoint filtered by current company, which is covered on our Company Employees API page.
Is employee count exact?
It is the figure the company page reports, which is based on how many members list that company as their employer. Treat it as a good relative signal rather than a headcount from payroll.
How much does a company lookup cost?
A company lookup is $0.0400 at Starter, and a company search page is $0.0400 regardless of how many results are on it. Both fall by your tier discount, to $0.0180 and $0.0180 at Scale.
Can I search companies by size and location together?
Yes. company-search accepts a keyword, a location or geoId, and a companySize filter, and returns paginated results with a pagination token for stable paging.