SCscrunchai

List Responses

Changed on

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

Request

  • Base URL
    https://api.scrunchai.com/v1
  • Auth
    HTTP bearer

Path parameters

brand_idinteger required

The unique identifier for the brand

Query parameters

platform'chatgpt' | 'claude' | 'google_ai_overviews' | 'perplexity' | 'meta' | 'google_ai_mode' | 'google_gemini' | 'copilot' | 'grok' | 'deepseek' 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
prompt_idinteger nullable

Filter responses to a specific prompt by its ID

persona_idinteger nullable

Filter responses to a specific persona by its ID

stagestring nullable

Filter responses by customer journey stage — the name of one of the brand's stages (custom stage names included). Default sets:

  • Advice - Seeking recommendations
  • Awareness - Exploring a topic
  • Evaluation - Assessing options
  • Comparison - Comparing alternatives
  • Other - Other prompt types
start_datestring nullable

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

has_shopping_databoolean nullable

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

has_sponsored_adsboolean nullable

Filter responses by sponsored-ad presence. True returns only responses with sponsored ads in their conversation (matching the sponsored_ads field; an entry with followup_prompt was shown after that follow-up question, not with the response text), False returns only responses without.

limitinteger

Maximum number of responses to return per page

offsetinteger

Number of responses to skip for pagination

Response

Successful Response

totalinteger required
offsetinteger
limitinteger nullable

Changes

  • fa6217fdd4e1Revision changes
    • info

      added the enum value deepseek to the property anyOf[subschema #1]/ of the query request parameter platform

  • 28440e6ef51eRevision changes
    • info

      added the optional property //// to the response with the status