Sign in

v1

latestOpenAPI 3.1.02026-07-263370112.1 KB

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
get/{brand_id}/responses

Path parameters

brand_idinteger required

The unique identifier for the brand

The unique identifier for the brand

Query parameters

platform'chatgpt' | 'claude' | 'google_ai_overviews' | 'perplexity' | 'meta' | 'google_ai_mode' | 'google_gemini' | 'copilot' | 'grok' nullable

Filter responses by AI platform.

Supported platforms:

  • chatgpt - OpenAI ChatGPT
  • claude - Anthropic Claude
  • google_ai_overviews - Google AI Overviews (Search)
  • perplexity - Perplexity AI
  • meta - Meta AI
  • google_ai_mode - Google AI Mode
  • google_gemini - Google Gemini
  • copilot - Microsoft Copilot

Filter responses by AI platform.

Supported platforms:

  • chatgpt - OpenAI ChatGPT
  • claude - Anthropic Claude
  • google_ai_overviews - Google AI Overviews (Search)
  • perplexity - Perplexity AI
  • meta - Meta AI
  • google_ai_mode - Google AI Mode
  • google_gemini - Google Gemini
  • copilot - Microsoft Copilot
prompt_idinteger nullable

Filter responses to a specific prompt by its ID

Filter responses to a specific prompt by its ID

persona_idinteger nullable

Filter responses to a specific persona by its ID

Filter responses to a specific persona by its ID

stagestring nullable

Filter responses by customer journey stage. Values are resolved from your brand's configured stages, so they vary per brand.

Default stage sets:

  • Intent (v1) — Advice, Awareness, Evaluation, Comparison, Other
  • Funnel (v2) — Awareness, Consideration, Conversion, Loyalty, Other

Brands that rename or add stages accept those custom names too.

Filter responses by customer journey stage. Values are resolved from your brand's configured stages, so they vary per brand.

Default stage sets:

  • Intent (v1) — Advice, Awareness, Evaluation, Comparison, Other
  • Funnel (v2) — Awareness, Consideration, Conversion, Loyalty, Other

Brands that rename or add stages accept those custom names too.

start_datestring nullable

Only return responses collected on or after this date (inclusive). Format: YYYY-MM-DD

Only return responses collected on or after this date (inclusive). Format: YYYY-MM-DD

end_datestring nullable

Only return responses collected before this date (exclusive). Format: YYYY-MM-DD

Only return responses collected before this date (exclusive). Format: YYYY-MM-DD

has_shopping_databoolean nullable

Filter responses by shopping data presence. True returns only responses with shopping results, False returns only responses without.

Filter responses by shopping data presence. True returns only responses with shopping results, False returns only responses without.

limitinteger

Maximum number of responses to return per page

Maximum number of responses to return per page

offsetinteger

Number of responses to skip for pagination

Number of responses to skip for pagination

Response

Successful Response

totalinteger required
offsetinteger
limitinteger nullable