Skip to Content
CompanySpec
API referenceCompanies

Resolve a company

GET
/companies/resolve

Turn a name, domain or LinkedIn URL into a company. Returns the best match and, if you ask for them with limit, up to 4 alternatives (fewer if there aren't that many good candidates). Use it to get the domain to pass to other endpoints. Provide at least one of name, domain or linkedin_url.

confidence (0–1) says how sure we are. Above 0.8 is usually right; below 0.5, check the alternatives. match is null when nothing is close enough.

Free. Limited to 60 requests per minute.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.

Query Parameters

name?string
Lengthlength <= 250
domain?string
Lengthlength <= 253
linkedin_url?string
Formaturi
country?string

ISO 3166-1 alpha-2 country code to prefer.

Length2 <= length <= 2
limit?integer

Total candidates to return, including the best match.

Range1 <= value <= 5
Default1

Response Body

Best match and alternatives.

application/json
  1. response
match*|null
alternatives*array<>
Example Request
curl -X GET 'https://api.companyspec.com/v1/companies/resolve?name=Mercury&country=US&limit=3'
Example Response
{  "match": {    "id": "cmp_5m0q2",    "domain": "mercury.com",    "name": "Mercury",    "logo_url": "https://logos.companyspec.com/mercury.com.png",    "confidence": 0.91  },  "alternatives": [    {      "id": "cmp_9w3ns",      "domain": "mercuryinsurance.com",      "name": "Mercury Insurance",      "logo_url": null,      "confidence": 0.62    }  ]}