DataForAEOby Advance Labs
Docs menu

GET · API key · Free

Measured AI demand

Measured AI demand for one of your sites, from the collector: hits by kind for this window and the one before, per page and per bot, with the verified share.

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

Parameters

NameTypeRequiredDescription
domainstringYesA project in your workspace with the collector installed.
daysintegerNo1 to 30, default 7. The window length.

Errors

HTTPcodeMeaning
400invalid_domaindomain is missing or not a valid domain.
400invalid_daysdays is not a whole number from 1 to 30.
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.
  • The window is the last days days, compared with the days before it.
  • Add the project and install the collector in AEO Toolkit first, or the call answers 404.

Returns: Measured AI demand.

Request
curl 'https://dataforaeo.dev/api/v1/demand?domain=example.com&days=7' \
  -H "Authorization: Bearer $DFA_KEY"
Response (trimmed, illustrative values)
{ "ok": true, "cost": { "checks": 0 }, "result": {
  "domain": "example.com", "days": 7,
  "current": { "user": 41, "search": 120, "training": 300 },
  "previous": { "user": 30, "search": 98, "training": 310 },
  "verifiedShare": 0.93, "pages": [ … ], "bots": [ … ] } }