# Answers (AI responses)

The AI responses behind every metric, with their full text, mentions, citations and sentiment analysis.

### GET `/answers`

List AI responses with their content. Returns paginated results with truncated response text (max 10,000 chars). Pass `query` for case-insensitive full-text search inside response texts: `total` becomes the exact count of matching responses, and each item returns `snippet` and `match_count` instead of the full `response`.

Params:

- `project_id` required
- `model`
- `collection_id`
- `prompt` prompt ID
- `country_code`
- `language_code`
- `from`
- `to`
- `page`
- `per_page`
- `query` full-text search
- `mention_filter`
- `citation_filter`
- `competitors`

The last three are the two-axis matrix from the Responses page: `mention_filter` takes `mentions_you`, `not_mentions_you`, `mentions_competitor`, `not_mentions_competitor`, `you_and_competitor`, `competitor_not_you`, `you_not_competitor` or `no_brands` (no tracked brand appears at all); `citation_filter` takes the same cells against cited domains (`cites_you`, `not_cites_you`, `cites_competitor`, `not_cites_competitor`, `you_and_competitor`, `competitor_not_you`, `you_not_competitor`, `cites_no_brands`). Both combine, and `competitors` (CSV of IDs) narrows the competitor side to those rivals. Unknown presets return `ERR_INVALID_PARAM`.

### GET `/answers/:id`

Get a single AI response with full details including mentions, citations, sentiments, and sources.

Params:

- `project_id` required
- `id` answer ID in URL

Full access. Cancel anytime.
