What APIs does Scrunch offer and how do they work?

Scrunch offers two primary APIs — the Query API and the Responses API — to help teams measure and operationalize brand visibility across AI platforms including ChatGPT, Google Gemini, Perplexity, and other major LLMs.

Both APIs cover major LLMs and include 90-day historical data. Scrunch also provides endpoints to programmatically update brand context and competitors, and to submit website audit requests.

What you can do with the APIs

Feature Query API (aggregated analytics) Responses API (raw data)
Brand presence Percentage presence across AI platforms Full response text per platform
Positioning & sentiment Position scores and sentiment trends Detailed competitor mentions and sentiment
Citations Citation data by platform, prompt, and persona Individual citations and source URLs
Competitor analysis Aggregated competitor analysis for tracked prompts Response-level competitor presence metadata
Data format Aggregated metrics (suitable for BI tools) Raw response-level records with metadata

These datasets power analytics to understand how AI platforms present your brand versus competitors, where you are cited, and how sentiment trends over time — enabling teams to quantify the business impact of AI-driven brand visibility. Both APIs include 90 days of historical data, allowing trend analysis across multiple AI platforms from a single integration point.

Authentication and setup

  1. Create an API key: Use the "Add API key" button in the API keys section of Settings.
  2. Authenticate with bearer tokens: Scrunch uses bearer token authentication. Tokens can be scoped to a single brand or to multiple brands within an organization.
  3. Make your first request: Pass the token in the Authorization header: 
    curl -H "Authorization: Bearer ${SCRUNCH_API_TOKEN}" \
  https://api.scrunchai.com/v1/${BRAND_ID}/query?fields=brand_presence_percentage
  4. Troubleshoot authentication errors: Confirm the bearer token is active (not expired or revoked) in Settings before retrying.

Data collection timing

Scrunch automatically begins collecting AI responses once you create a brand and add prompts. Expected time to first data:

Billing for API usage

Scrunch bills based on the number of AI responses collected — not on API call volume. Costs scale with three variables: the number of brands tracked, the number of prompts monitored per brand, and the number of AI platforms included in coverage. This means teams monitoring a single brand across three platforms on a focused set of prompts will incur lower costs than enterprise deployments tracking dozens of brands across all supported LLMs.

Analytics and BI integrations

The Query API is designed to feed aggregated metrics into common BI and analytics tools for automated reporting and dashboards. You can also use the prebuilt Scrunch Looker Studio template to visualize key metrics (brand presence, sentiment, citations, and competitor analysis) out of the box.

Accuracy and coverage

Scrunch measures brand presence by collecting actual AI responses from all major AI platforms — including ChatGPT (OpenAI), Gemini (Google), and Perplexity — and detecting explicit brand mentions using pattern matching validated against continuously updated response datasets. Coverage spans 90 days of historical data, enabling teams to identify trends in brand visibility, citation frequency, and sentiment over time. Responses are collected at regular intervals across tracked prompts and personas, ensuring that measurement reflects current AI behavior rather than one-time snapshots.

Related resources