When to use company enrichment
- Account research: you have a company’s LinkedIn URL or website and want the firmographics behind it.
- Finding a company’s LinkedIn page: you have a list of websites. A search by domain returns the company’s LinkedIn URL along with its record.
- Getting a domain for the email finder: the returned
email_domainlets you find people’s work emails at that company by name with the email finder. - Qualifying accounts: filter by industry, headcount, headquarters country, or founded year before you reach out.
- Building lookalike lists:
similar_companieslists comparable companies, each with a LinkedIn URL you can enrich next.
Enriching more than one company? Use bulk company enrichment. You submit up to 100,000 companies in one job, duplicates are charged once, and results come back in the order you sent them.
Making a request
Send aGET request to /v1/company-enrichment with the company’s LinkedIn URL in the linkedin_url query parameter, or its website in the domain query parameter. Send one or the other, not both. Include your API key in the X-API-Key header.
linkedin_url value. The Python and JavaScript examples above do this for you.
A found company looks like this:
Searching by domain
To start from a website instead, senddomain:
input set to the domain you sent.
- What you can send. A bare domain (
kearney.com), a subdomain (www.kearney.com) or a full URL (https://www.kearney.com/about). OrbiSearch reduces it to the registrable domain,kearney.com. - Only an exact match counts. A search by domain only returns a company whose own website is on that domain. When there is none, the result is
not_found, rather than a guess at a company with a similar name. - Redirects. If the website redirects to another domain, for example after a rebrand, a company whose website is on the new domain counts too. The response then has
is_redirect: true, andredirected_tonames the domain it redirects to. - What’s rejected. A LinkedIn URL sent as
domain(send it aslinkedin_url), a value that isn’t a website domain, or a site on a shared website-builder address rather than its own domain. These get a422and are not charged.
Which LinkedIn URLs work
Send the company’s LinkedIn URL as you have it. Company pages (/company/<name>) and showcase pages (/showcase/<name>) both work, with or without https:// and www, on a country subdomain such as uk.linkedin.com, and with extra path or query text such as /about/ or ?trk=.... The response’s linkedin_url is the company’s canonical URL.
Numeric company URLs such as linkedin.com/company/1035 are not supported. Use the company’s name URL instead. They are rejected with 422 and not charged, like any other URL that isn’t a LinkedIn company or showcase page.
Interpreting the response
A few fields are worth knowing about:
domainis the company’s website domain. It isnullwhen the company has no website of its own.email_domainis the domain the company’s email is at. It can differ fromdomain.company_sizeis the company’s self-reported headcount range.employee_countis an estimated headcount.linkedin_idis a stable numeric ID for the company. It stays the same when a company changes its name or URL, so it’s the most reliable key to store.inputis exactly what you sent, LinkedIn URL or domain.is_redirectandredirected_toonly apply to searches by domain (see above). They are alwaysfalseandnullon a search by LinkedIn URL.- Any individual field can be
nullwhen that detail isn’t available for the company.
Pricing
Each request costs 1 credit. Every returned response is charged,found and not_found alike, by LinkedIn URL or by domain, including repeat requests for the same company. Refunds are issued only when OrbiSearch infrastructure cannot complete the request (502). Requests rejected with 422 are not charged.
Rate limits
This endpoint shares the 20 requests per second per account limit with the rest of the/v1/* API.