One GET returns the permanent numeric company id as clean JSON.
Call GET /v1/linkedin?type=company with a company URL. The response carries company.linkedInId, LinkedIn's permanent numeric company id, by default. There is no extra flag to set.
The slug in a company URL, like /company/stripe, is easy to read but easy to change. The numeric id is the one LinkedIn keeps forever.
Point one request at any public company page and you get it back, plus the rest of the public page in the same call.
This is the exact JSON the curl above returned, trimmed for width. It came back in 884 ms and cost 1 credit.
The id you want is company.linkedInId, here "2135371" for Stripe. It rides along on every company call, so the same request that gives you the numeric id also gives you the tagline, website, industry, size, headquarters, and follower count.
Names and URLs move. The numeric id does not. That makes it the join key you actually want in a database.
A company can rebrand, change its display name, or edit its vanity URL, and any data keyed on the slug breaks the moment it does. The numeric id survives all of that.
It is the stable value to store, dedupe on, and match against records from other sources.
The slug is for people, the numeric id is for machines. universalName is the readable handle from the URL and it can be changed by the page owner. linkedInId is the permanent numeric id and it cannot. Store both if you like, but key your records on the numeric id.
From zero to your first company id in about two minutes:
Create a free account. You get 3,000 credits a month, no card needed.
Copy your key from the dashboard. It is issued the moment you sign up.
Run the curl above with any company URL. The numeric id comes back in company.linkedInId.
Every successful company call is one credit. A page that is not accessible returns a null result and is not charged. Here is what the packs cost:
| Company lookups | Credits | You pay |
|---|---|---|
| 3,000 every month | 3,000 | $0, free tier, no card |
| 25,000 lookups | 25,000 | $49 ($1.96 per 1,000) |
| 100,000 lookups | 100,000 | $149 ($1.49 per 1,000) |
| 500,000 lookups | 500,000 | $549 ($1.10 per 1,000) |
| 2.5 million lookups | 2,500,000 | $1,999 ($0.80 per 1,000) |
Packs continue up to 250 million credits for $100,000, which is $0.40 per 1,000. Prices ex-tax.
Credits are prepaid and never expire, so an unused pack is still yours next year.
Send a GET request to /v1/linkedin?type=company with the company URL. The response includes company.linkedInId, LinkedIn's permanent numeric company id. No extra flag is needed, and it comes back by default on every company call.
It is the permanent numeric id LinkedIn assigns to a company page, like 2135371 for Stripe. Unlike the slug in the URL, the numeric id does not change when a company renames itself or edits its vanity URL, so it is the stable key to join data on.
No. The call reads only the public, logged-out company page, so there is no cookie to paste, no session to hand over, and no account of yours in the loop.
One credit per successful call. A company page that is not accessible returns null with a note and is not charged. The free tier is 3,000 credits a month with no card, and credits never expire.
The rest of the public company page in the same call: name, tagline, website, industry, size, employee count, headquarters, founding year, follower count, logo, and the company URL, all as clean JSON alongside linkedInId.
Start on the free 3,000 credits a month, no card needed. One GET returns the company id and the public page as clean JSON, and a page that is not accessible costs you nothing.
Get 3,000 free credits