Individual Lookup

Look up one company's current employee headcount from its domain. Synchronous, returns the headcount directly.

POST /headcount

Costs 0.2 credits per company, charged only when a headcount is found. Returns the headcount directly in the response, no list and no polling.

Pass a company domain. The response contains the employee band in data.company_size, and an exact number in data.headcount when the source provides one.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
domain	string	Company domain, e.g. acme.com.

Response

The record is under data. See Response Format for the fields every endpoint returns.

Field	Description
domain	The bare domain that was looked up.
company_size	Employee band, written as plain numbers, e.g. 1001-5000 or 10001+.
headcount	Exact employee count when the source gives one, otherwise null. Always a whole number, never a range.

When neither a band nor an exact count is found, status is not_found.

Example

Input

{
  "api_key": "your_api_key",
  "domain": "anthropic.com"
}

Output

{
  "status": "success",
  "data": {
    "domain": "anthropic.com",
    "company_size": "1001-5000",
    "headcount": null
  },
  "credits_used": 0.2,
  "credits_remaining": 7781.3,
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "domain: Field required"
  },
  "success": false
}

To look up every company in a list in one call instead, use List Lookup.