API

Look up what any domain runs, over HTTPS, in JSON. Keys live on your account page.

Quickstart

Create a key on your account page, then ask about a domain:

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

The response is the domain profile we serve on the site:

{ "data": { "domain": "allbirds.com", "resolves": true, "technologies": ["Shopify", "Cloudflare", "Google Tag Manager", "PayPal", "Zendesk", "..."], "network": "Shopify", "platform": "shopify", "country_iso": null, "lang_norm": "en" } }

Authentication

Every request carries Authorization: Bearer gdd_live_…. We store a hash of the key, never the key, so the full secret appears once, at creation. A revoked key stops working on the next request. Keys belong to your account, not to a seat, and there is no charge for extra keys.

Endpoints

EndpointReturnsCosts
GET /api/v1/domain/{domain}One domain profile1 lookup
POST /api/v1/domains/batchUp to 100 profiles per call. Body: {"domains": [...]}. Domains we do not hold come back in a missing array.1 lookup per domain
GET /api/v1/traffic/{host}Our estimated monthly visits for one hostname, with the monthly history (estimated_monthly_visits, band,as_of, history[]). Estimates are per hostname and do not carry across subdomains.1 lookup
GET /api/v1/employees/{host}Our estimated employee count for the organisation behind a hostname (low, high, and apoint figure when we hold one). Keyed by the registrable domain, so every host under it returns the same estimate.1 lookup
GET /api/v1/technology/{name}The domain count for one technologyFree
GET /api/v1/meta/technologiesThe full technology catalog with counts, by categoryFree
Domain lists for a technology are not an API surface today. Browse them on the technology pages; the depth depends on your plan.

Metering

PlanLookups a monthRequests a minute
Pro2,00060
Business50,000300
Business Plus250,000600
One lookup is one domain queried, however many technologies come back. A batch of 100 domains spends 100 lookups, found or not. Extra lookups come in packs of 25,000.

Errors

401 invalid_keyThe key is missing, malformed, or revoked.
402 quota_exhaustedThe month's lookups are spent. The API never throttles silently: at the limit it answers 402 until the month rolls over or a pack is added.
429 rate_limitedToo many requests this minute. The body carries a reset time.
404 not_foundWe do not hold that domain. The lookup is still spent.
Every response carries X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset, so your integration can watch its budget without a dashboard.