Company Firmographics
Industry codes, headcount, revenue band and growth for a company domain.
curl -X POST https://api.1lookup.dev/v1/company-firmographics \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"example.com"}'{
"success": true,
"data": {
"matched": true,
"domain": "example.com",
"legal_name": "Northwind Logistics, Inc.",
"industry": {
"name": "Freight transportation arrangement",
"sic": "4731",
"naics": "488510"
},
"employees": {
"count": 184,
"band": "51-200",
"growth_12m_pct": 12.4
},
"revenue_band": "$25M-$50M",
"headquarters": {
"city": "Columbus",
"state": "OH",
"country": "US"
},
"founded_year": 2011
},
"meta": {
"credits_used": 75,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
domainstring<domain>requiredDomain. The company's primary website domain. Example: example.com
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.legal_namestringThe registered name of the company behind the domain.
data.industry.sicstringThe four-digit Standard Industrial Classification code.
data.industry.naicsstringThe six-digit North American Industry Classification System code.
data.employees.countnumberEstimated number of employees, with the size band it falls into.
data.employees.growth_12m_pctnumberPercentage change in employees over the past 12 months. Negative means the company shrank.
data.revenue_bandstringEstimated annual revenue as a range, not a single figure.
data.headquartersobjectCity, state or region, and country of the head office.
data.founded_yearnumberThe year the company was founded.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
75 credits / match. Charged only when a match is found. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases