API key auth

Interactive

GTD API — Interactive docs

One gateway, nine domain-intelligence endpoints, no OAuth. Authenticate with an API key, call any tool over GET or POST, and test everything from this page.

Generate an API key Jump to endpoints Pricing & limits

Authentication

Send your key in the x-api-key header, or asAuthorization: Bearer <key>. Never expose keys in client-side code.

Billing

Paid endpoints draw plan credits first. When the allowance runs out, calls continue and are billed as metered overage on your next invoice instead of failing.

Base URL

https://globaltrafficdomains.site/api/public/gateway

GET {base} returns a machine-readable discovery document.

Quick start

cURL

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/buy-score?domain=example.com"

Node.js

const res = await fetch(
  "https://globaltrafficdomains.site/api/public/gateway/buy-score",
  {
    method: "POST",
    headers: {
      "content-type": "application/json",
      "x-api-key": process.env.GTD_API_KEY,
    },
    body: JSON.stringify({ domain: "example.com" }),
  }
);
console.log(await res.json());

Python

import os, requests
r = requests.get(
  "https://globaltrafficdomains.site/api/public/gateway/buy-score",
  params={"domain": "example.com"},
  headers={"x-api-key": os.environ["GTD_API_KEY"]},
)
print(r.json())

Rate limits

Limits are per API key and scale with your plan. Every successful response includesx-ratelimit-remaining-minute andx-ratelimit-remaining-month headers.

Plan	Requests / minute	Requests / month
No plan (free)	5	500
starter	5	10,000
standard	15	50,000
premium	30	200,000
enterprise	60	1,000,000

Webhook events

Billing events are delivered by Stripe to/api/public/payments/webhook?env=liveand applied to your credit balance automatically. You do not need to configure anything — this is documented so you know what changes your quota and when.

Event	Effect on your account
customer.subscription.created	Plan activated; monthly credit allowance granted and rate limits raised to your tier.
customer.subscription.updated	Plan change, renewal or cancellation scheduling; allowance and limits re-applied.
customer.subscription.deleted	Plan ends; keys fall back to free-tier rate limits.
checkout.session.completed	Top-up purchase confirmed; credits added to your top-up balance.
invoice.created	Metered overage for the period is reconciled onto the upcoming invoice.
invoice.paid	Overage settled; overage records marked paid in your billing history.

Outbound webhooks to your own endpoint are not offered yet. Poll the dashboard or read thex-ratelimit-* headers on each response to track quota in real time.

Endpoints

GET · POST

/api/public/gateway/buy-score— Buy Score

1 credit

0-100 buy score, band, recommended action, confidence and signal contributions.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "buy-score",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "paid",
    "credits_charged": 1,
    "metered_overage": false
  },
  "data": {
    "buy_score": 82,
    "band": "buy",
    "action": "Strong acquisition candidate — bid confidently.",
    "confidence": 91
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/buy-score?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/valuation— Valuation

1 credit

Estimated market value and list price with AI score, authority, niche and age.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "valuation",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "paid",
    "credits_charged": 1,
    "metered_overage": false
  },
  "data": {
    "estimated_value_usd": 4820,
    "list_price_usd": 199,
    "ai_score": 74,
    "authority": 42,
    "niche": "finance",
    "age_years": 11
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/valuation?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/traffic-forecast— Traffic Forecast

1 credit

Current monthly traffic plus 30/90/365-day projections, growth and confidence.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "traffic-forecast",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "paid",
    "credits_charged": 1,
    "metered_overage": false
  },
  "data": {
    "current_monthly_traffic": 12500,
    "predicted_growth_pct": 42,
    "predicted_traffic_365d": 17750,
    "confidence": 78
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/traffic-forecast?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/backlink-strength— Backlink Strength

free

Backlink strength score, totals, referring domains, dofollow ratio and spam score.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "backlink-strength",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "free",
    "credits_charged": 0,
    "metered_overage": false
  },
  "data": {
    "backlink_strength": 68,
    "backlinks": 8450,
    "referring_domains": 512,
    "dofollow_ratio_pct": 62,
    "spam_score": 12
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/backlink-strength?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/market-demand— Market Demand

free

Demand score, buyer velocity, demand drivers and trend direction.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "market-demand",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "free",
    "credits_charged": 0,
    "metered_overage": false
  },
  "data": {
    "market_demand_score": 74,
    "velocity": 12,
    "trend": "rising"
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/market-demand?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/liquidity— Liquidity

free

Liquidity score, band, estimated days to sell and comparable sales velocity.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "liquidity",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "free",
    "credits_charged": 0,
    "metered_overage": false
  },
  "data": {
    "liquidity_score": 63,
    "band": "medium",
    "estimated_days_to_sell": 87,
    "comparable_sales_velocity": 3.2
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/liquidity?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/expiry-opportunity— Expiry Opportunity

free

Opportunity score, days to expiry, expiry date, band, urgency and drivers.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "expiry-opportunity",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "free",
    "credits_charged": 0,
    "metered_overage": false
  },
  "data": {
    "expiry_opportunity_score": 88,
    "days_to_expire": 4,
    "band": "hot",
    "urgency": "critical"
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/expiry-opportunity?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/auction-prediction— Auction Prediction

2 credits

Predicted closing price, recommended max bid, win probability and flip profit.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "auction-prediction",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "paid",
    "credits_charged": 2,
    "metered_overage": false
  },
  "data": {
    "predicted_closing_price_usd": 2140,
    "recommended_max_bid_usd": 1650,
    "win_probability_pct": 62,
    "flip_profit_usd": 2680
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/auction-prediction?domain=example.com"

Need a key? Generate one.

GET · POST

/api/public/gateway/authority-repository— Authority Repository

1 credit

Current authority, trajectory score, 12-month prediction, band and history.

Input: domain (required) — query param on GET, JSON body field on POST.

Sample response

{
  "ok": true,
  "domain": "example.com",
  "tool": "authority-repository",
  "generated_at": "2026-08-01T10:00:00.000Z",
  "plan": "standard",
  "billing": {
    "tier": "paid",
    "credits_charged": 1,
    "metered_overage": false
  },
  "data": {
    "current_authority": 42,
    "authority_trajectory_score": 74,
    "predicted_authority_12mo": 51,
    "trajectory_band": "rising"
  }
}

Try it live

curl -H "x-api-key: $GTD_API_KEY" \
  "https://globaltrafficdomains.site/api/public/gateway/authority-repository?domain=example.com"

Need a key? Generate one.

Error codes

Status	Error	Meaning
400	invalid_domain	The domain query param / body field is missing or malformed.
401	missing_api_key	No API key in x-api-key or Authorization header.
401	invalid_api_key	Key not recognized.
401	revoked_api_key	Key was revoked from the dashboard.
402	insufficient_credits	Out of credits and metered overage is unavailable — add a payment method or buy credits.
404	unknown_tool	No gateway tool with that name; see the discovery document.
429	rate_limited	Per-minute limit for your plan exceeded — retry after the retry-after header.
429	monthly_quota_exceeded	Monthly request quota for your plan exceeded.
500	internal_error	Unexpected server-side failure — retry with backoff.

Next steps

Create a key See plans Fair usage policy