Help · 20 answers
Help
Short answers about the API, the collector, verification, billing and the data.
API 9
Only the two free endpoints allow it. They send CORS headers; the keyed endpoints do not, so keys stay on your server.
How do I authenticate DataForAEO API requests?Send your key in the Authorization header as Bearer dfa_live_..., on every request to the keyed endpoints.
How do I get a DataForAEO API key?Create an API key in the DataForAEO console at console.dataforaeo.dev, signing in with an AEO Toolkit account.
How do I revoke a DataForAEO API key?Revoke the key in the console. A revoked key is refused immediately with a 401 unauthorized error.
How many prompts can I send to /api/v1/answers/live?Between 1 and 5 per call, after duplicates are merged. Each prompt and engine pair costs one check.
What are the DataForAEO API rate limits?A key is limited to 120 calls a minute, and calls without a key to 30 a minute per IP address.
What do the DataForAEO API error codes mean?Errors use real HTTP statuses: 400 for a bad request, 401 for a bad key, 402 for quota, 404, 405, 429 for rate limits, 500 for our side.
What does a DataForAEO API response look like?Every response is a JSON envelope with ok, request_id, time_ms and either a result with a cost, or an error.
Why does /api/v1/demand return not_found?The domain you passed is not a project in the key’s workspace. Add it in AEO Toolkit and install the collector.
Collector 4
No. The snippet checks the User-Agent and sends AI-bot hits after the response, so pages never wait on it.
How do I install the DataForAEO collector?Open AI demand in AEO Toolkit, create a collector key, and add a snippet to your site, or use the Vercel drain or WordPress plugin.
How old can an event sent to the collector be?An event may carry a timestamp up to 48 hours old. Older or future timestamps are replaced with the time it was received.
What does the DataForAEO collector store?Daily counts per page, bot, kind and verification. No IP addresses, no query strings, no cookies and no human traffic.
Verification 3
POST the User-Agent and IP to /api/v1/ai-crawlers/verify. It is free, needs no key and stores nothing.
What do verified, unverified and unknown mean?Verified means the IP is in the vendor’s published ranges. Unverified means it is not. Unknown means we could not check.
Which AI vendors can DataForAEO verify by IP?Five: OpenAI, Anthropic, Perplexity, Mistral and Amazon. Every other agent is recorded as unknown.
Billing 2
Data 2
Estimated. No AI company publishes query volume, so DataForAEO labels any AI volume figure an estimate.
What counts as AI demand in DataForAEO?Only user fetches: hits from agents that fetch a page because a person asked. Search and training crawls are shown but not counted.
Not here? Talk to us.