Skip to main content
The Responses API provides row-level access to all AI responses Scrunch captures, including:
  • Full response text (markdown)
  • Citations (URL, snippet, source type, domain)
  • Brand and competitor evaluation
  • Persona, platform, tags, topics, and stage metadata
This API is designed for ETL pipelines, research, full-text analysis, custom UIs, and advanced modeling.

​
When to use the Responses API

Choose this API if you need:
  • Per-response insight
  • Exact text used by AI platforms
  • Citation-level metadata
  • Competitor presence, sentiment, and position
  • Daily or hourly ingestion jobs with high watermarks

​
Example request

curl -X GET \
  "https://api.scrunchai.com/v1/1234/responses?start_date=2025-01-01&end_date=2025-01-31&limit=1000" \
  -H "Authorization: Bearer $SCRUNCH_API_TOKEN"

​
Pagination model

Responses use Scrunch’s standard collection envelope: 
{
  "total": 5132,
  "offset": 0,
  "limit": 1000,
  "items": [ ... ]
}
To retrieve the next page: 
offset = offset + limit
This pattern supports stable ETL jobs.
  1. Start with start_date (UTC)
  2. Pull responses in batches (limit=1000)
  3. Store created_at from the last record
  4. Use that as the new start date for your next batch
  5. Deduplicate using id (globally unique)

​
Response shape

Each response includes:
  • response_text – full markdown
  • citations[] – URLs, snippet, title, domain
  • competitors[] – presence, sentiment, position
  • brand_sentiment, brand_position
  • platform, prompt_id, stage, tags, key_topics

Get started with Responses

Responses API Quickstart →