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. - Cost
- Free. How cost is counted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | A project in your workspace with tracked keywords. |
keyword | string | No | Case-insensitive exact match after trim. Omit to return every tracked keyword. |
Errors
| HTTP | code | Meaning |
|---|---|---|
| 400 | invalid_domain | domain is missing or not a valid domain. |
| 401 | unauthorized | The key is missing, malformed, unknown or revoked. |
| 404 | not_found | No project for that domain in the key’s workspace. |
| 429 | monthly_limit | The 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. |
| 429 | rate_limited | 120 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_estimateis 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.