GET /employees/{host}

Costs 1 lookup

Our estimated headcount for the organisation behind a hostname. Keyed by the registrable domain, so every host under an apex returns the same figure.

Base URL https://getdomaindata.com/api/v1

Parameters

Name	In	Type	Required	Meaning
host	path	string	yes	Any hostname under the organisation's domain.

Request

curl

curl https://getdomaindata.com/api/v1/employees/allbirds.com \
  -H "Authorization: Bearer gdd_live_YOUR_KEY"

JavaScript

const KEY = process.env.GDD_API_KEY;
const r = await fetch("https://getdomaindata.com/api/v1/employees/allbirds.com", { headers: { Authorization: "Bearer " + KEY } });
const { data } = await r.json();
console.log(r.headers.get("X-Quota-Remaining"), data);

Python

import os, requests
h = {"Authorization": "Bearer " + os.environ["GDD_API_KEY"]}
r = requests.get("https://getdomaindata.com/api/v1/employees/allbirds.com", headers=h)
print(r.headers.get("X-Quota-Remaining"), r.json()["data"])

Response

A real record from the serving database, abridged where marked with an ellipsis. Null stays null.

{
  "data": {
    "host": "allbirds.com",
    "apex": "allbirds.com",
    "estimated_employees": {
      "low": 501,
      "high": 2000,
      "point": null
    },
    "as_of": "2026-09-10"
  }
}

Field	Type	Meaning
apex	string	The registrable domain the estimate belongs to.
estimated_employees.low	number	Lower bound of the band.
estimated_employees.high	number \| null	Upper bound; null means the top band is open-ended.
estimated_employees.point	number \| null	A specific figure when we hold one. Still an estimate.
as_of	string \| null	Date of the estimate.

Errors this endpoint returns

All errors

401 invalid_key	The key is missing, malformed, or revoked. Check the Authorization header and the key on your account page. Revoked keys stop on the next request.
429 rate_limited	Too many requests this minute for your plan. Back off until the reset time in the body, then retry.
402 quota_exhausted	This month's lookups are spent. Wait for the first of the month, or add a pack from the account page. The API never throttles silently.
400 bad_host	The hostname is not plausible. Same rule as bad_domain.
404 not_found	We do not hold that domain or technology. Nothing to retry. The lookup is still spent for domain calls.
503 metering_unavailable	The quota could not be read, so nothing was served. Retry in a moment. No lookup was spent.

Employee estimate

GET /employees/{host}

Parameters

Request

Response

Errors this endpoint returns