Company Lookup
How the Company Lookup endpoint works, how credits are charged, and how to avoid unnecessary credit burn.
The Company Lookup endpoint (/api/v2/company/resolve) resolves a company name or domain to its LinkedIn company profile URL. Use it when you have a domain or company name but not a LinkedIn URL.
What it does
Given a company domain or name, the endpoint finds the matching LinkedIn company page and returns its URL. You can optionally narrow results by country using company_location.
GET /api/v2/company/resolve
?company_domain=accenture.comRequired parameters: company_domain or company_name (at least one)
Optional parameters: company_location (ISO 3166-1 alpha-2 country code)
A successful match returns the LinkedIn company URL and, if enrich_profile=enrich is set, the full company profile in the same response (costs 1 additional credit).
How credits are charged
Cost: 2 credits per 200 OK response.
Credits are charged whenever the API returns HTTP 200, even if the result is null. The endpoint uses external search (SERP) as a fallback when the company is not found in the internal index, and that lookup cost is incurred regardless of whether a match is found.
There is no opt-out parameter for null results on this endpoint. If you receive a null response, credits are still deducted.
How matching works
The endpoint searches three data sources in order:
- Internal index (Elasticsearch) — fastest and most reliable; handles exact and subdomain matches
- Mixrank — external fallback when the internal index has no match
- SERP — final fallback using Google search results
When multiple companies share a domain (e.g., subsidiaries, shared platforms), the algorithm prioritizes:
- The domain owner over subsidiaries
- Parent companies over subsidiaries using the parent's domain
- Exact domain matches over subdomain matches
- Companies whose name better matches the domain
Best practices
- Use the canonical domain — Pass the root domain (e.g.,
accenture.com) rather than subdomains or paths to get the most accurate match. - Add
company_locationfor common names — For generic or regional company names, including a country code reduces ambiguous matches. - Deduplicate domains before calling — If your list contains repeated domains, deduplicate first. Each call costs 2 credits regardless of whether you've already looked up that domain.
- Chain with Company Profile for fresh data — The lookup returns a cached snapshot. For up-to-date profile data, follow up with the Company Profile endpoint using
use_cache=if-recent.
Coming in API v3
API v3 will not charge credits when the response is null or empty, for all lookup endpoints. If you are migrating to v3, this billing behavior will change automatically — you will only be charged when a result is actually returned.