DataForAEOby Advance Labs
Docs menu

GET · API key · Free

Keyword volumes

Weekly Bing search volume (measured) and AI-assistant demand (ai_estimate, modelled) for keywords you already track on a site in AEO Toolkit.

Endpoint
GET https://dataforaeo.dev/api/v1/keywords
Authentication
API key, sent as Authorization: Bearer dfa_live_…. How keys work.

Parameters

NameTypeRequiredDescription
domainstringYesA project in your workspace with tracked keywords.
keywordstringNoCase-insensitive exact match after trim. Omit to return every tracked keyword.

Errors

HTTPcodeMeaning
400invalid_domaindomain is missing or not a valid domain.
401unauthorizedThe key is missing, malformed, unknown or revoked.
404not_foundNo project for that domain in the key’s workspace.
429monthly_limitThe workspace used its API requests for the month. The allowance depends on the plan (see requests in /me); it resets on the 1st, UTC. The body carries an upgrade hint.
429rate_limited120 calls a minute per key. Wait for retry-after.

Every error code and the response envelope

Notes

  • No CORS on keyed endpoints: call it from a server, never from a browser, so the key stays private.
  • ai_estimate is modelled from Bing by query intent. It is never labelled measured.
  • Only keywords already tracked in AEO Toolkit are returned. Add the project and track keywords there first, or the call answers 404.
  • Free plan can read this endpoint. Each call counts against the plan’s monthly API requests.

Returns: AI keyword volume.

Request
curl 'https://dataforaeo.dev/api/v1/keywords?domain=example.com' \
  -H "Authorization: Bearer $DFA_KEY"
Response (trimmed, illustrative values)
{ "ok": true, "cost": { "checks": 0 }, "result": {
  "domain": "example.com",
  "keywords": [ { "keyword": "best crm", "market": "us",
    "weeks": [ { "week": "2026-11-07", "bing": 120, "ai_estimate": 18 } ] } ] } }