List Responses
Returns AI responses (observations) with full evaluation data, citations, and competitor analysis. Each response represents a single AI-generated answer to a tracked prompt.
This endpoint provides the raw response data needed for deep analysis, audits, and research. For aggregated metrics, use the Query API instead.
Response data includes:
- Full response text from the AI platform
- Brand evaluation (presence, sentiment, position)
- Competitor evaluations with individual metrics
- Citations with source classification (brand/competitor/other)
- Prompt and persona context
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier for the brand
Query Parameters
Filter responses by AI platform.
Supported platforms:
chatgpt- OpenAI ChatGPTclaude- Anthropic Claudegoogle_ai_overviews- Google AI Overviews (Search)perplexity- Perplexity AImeta- Meta AIgoogle_ai_mode- Google AI Modegoogle_gemini- Google Geminicopilot- Microsoft Copilot
chatgpt, claude, google_ai_overviews, perplexity, meta, google_ai_mode, google_gemini, copilot, grok Filter responses to a specific prompt by its ID
Filter responses to a specific persona by its ID
Filter responses by customer journey stage.
Available stages:
Advice- Seeking recommendationsAwareness- Exploring a topicEvaluation- Assessing optionsComparison- Comparing alternativesOther- Other prompt types
Advice, Awareness, Evaluation, Comparison, Other Only return responses collected on or after this date (inclusive). Format: YYYY-MM-DD
Only return responses collected before this date (exclusive). Format: YYYY-MM-DD
Filter responses by shopping data presence. True returns only responses with shopping results, False returns only responses without.
Maximum number of responses to return per page
x >= 1Number of responses to skip for pagination
x >= 0