GET /traffic/{host}

Costs 1 lookup

Our estimated monthly visits for one hostname, with the month-by-month history behind the current figure. The basic profile already carries the latest figure; use this when you want the series.

The history values in this example are illustrative of the shape; the current figure and band are the live row.

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

Parameters

Name	In	Type	Required	Meaning
host	path	string	yes	A hostname. Estimates are per hostname and do not carry across subdomains.

Request

curl

curl https://getdomaindata.com/api/v1/traffic/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/traffic/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/traffic/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",
    "estimated_monthly_visits": 2137979,
    "band": "1M-10M",
    "as_of": "2026-08",
    "history": [
      {
        "month": "2026-06",
        "visits": 2050000
      },
      {
        "month": "2026-07",
        "visits": 2110000
      },
      {
        "month": "2026-08",
        "visits": 2137979
      }
    ]
  }
}

Field	Type	Meaning
host	string	The hostname asked for.
estimated_monthly_visits	number	Our estimate for the latest month.
band	string	The range the estimate falls in, for example 1M-10M.
as_of	string	The latest month, YYYY-MM.
history	{month, visits}[]	Earlier months where we hold a figure, oldest first.

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.

Traffic estimate with history

GET /traffic/{host}

Parameters

Request

Response

Errors this endpoint returns