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. - Cost
- Free. How cost is counted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | A project in your workspace with the collector installed. |
days | integer | No | 1 to 30, default 7. The window length. |
Errors
| HTTP | code | Meaning |
|---|---|---|
| 400 | invalid_domain | domain is missing or not a valid domain. |
| 400 | invalid_days | days is not a whole number from 1 to 30. |
| 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.
- The window is the last
daysdays, compared with thedaysbefore it. - Add the project and install the collector in AEO Toolkit first, or the call answers 404.
Returns: Measured AI demand.