GET · API key · Free
Citation index
Which domains AI answers cite for a topic, as shares across workspaces. Published only when at least 5 workspaces have matching prompts (privacy floor); otherwise insufficient_sample.
- Endpoint
GET https://dataforaeo.dev/api/v1/citations- Authentication
- API key, sent as
Authorization: Bearer dfa_live_…. How keys work. - Cost
- Free. How cost is counted.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
topic | string | Yes | Exact prompt match after lowercase and collapsed whitespace. Not embeddings. |
Errors
| HTTP | code | Meaning |
|---|---|---|
| 400 | invalid_topic | topic is missing or empty after trim. |
| 400 | insufficient_sample | Fewer than 5 workspaces have a matching prompt. The error carries sample_size; no domain list is returned. |
| 401 | unauthorized | The key is missing, malformed, unknown or revoked. |
| 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.
- Topic matching is exact after normalize (lowercase, collapse spaces). Prompt text never appears in the response.
- rank_distribution counts how often the host appears at each 1-based position in an answer sources list.
Returns: Citation index.