Find company ID
Companies
Find company ID
Resolve a batch of alternate identifiers (domain, website, LinkedIn 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.
This endpoint is free; resolving identifiers to IDs uses no 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, 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) return at most one company, withmatch_confidence1. 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.