Find company ID
Companies
Find company ID
Resolve a batch of alternate identifiers (domain, website, LinkedIn, Crunchbase or Pitchbook URL, or company name) into the Specter company id. Re-use that id with the id-only company endpoints such as Get company by ID.
Free. This call does not consume credits. The id-only endpoints you call next are charged as usual.
What you need
One or more identifiers to resolve: a domain, website, LinkedIn URL, Crunchbase URL, Pitchbook URL, or company name (1–50 per request). No Specter ID is required; that is what this returns.
Behaviour
- Pass identifiers under
to_resolve(1-50 per request). Each entry must carry exactly one identifier; none, or more than one, returns a validation error. - The response has one result group per input, in the same order, so you can attribute each set of matches back to what you sent.
queryechoes the normalized identifier. domainmatches the primary domain and any domain aliases;website_urlis reduced to its domain before matching.- Exact identifiers (
domain,website_url,linkedin_url,crunchbase_url,pitchbook_url) return at most one company, withmatch_confidence1. crunchbase_urlmust point at an organization profile;pitchbook_urlat a Pitchbook profile. Both accepthttp/https,www, query strings and anchors, and are normalized before matching.nameis fuzzy-matched and can return several ranked candidates (at most 10). Each carries amatch_confidencefrom 0 to 1, relative to the other results for that query; use the extra fields (domain, HQ, founded year) to pick the right one.- An identifier that matches nothing keeps its place with an empty
matcheslist.
What you do next
- Get the full profile. Pass the returned
company_idto Get company by ID. - See who it competes with. Feed the
company_idto Get company competitors. - Track its news. Pull Get company news for the resolved company.
POST
Find company ID
Authorizations
Body
application/json
The identifiers to resolve.
Required array length:
1 - 50 elementsResponse
One result group per input identifier, in the same order as to_resolve.