What APIs does Scrunch offer and how do they work?

Scrunch offers two primary APIs to help teams measure and operationalize brand visibility across AI platforms:

• Query API for aggregated metrics (brand presence, position, sentiment, citations, and more) across prompts and AI platforms
• Responses API for raw AI responses (full text, citations/URLs, competitor presence, and metadata)

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

• Query API (aggregated analytics)
• Brand presence percentages across AI platforms
• Position scores and sentiment
• Citation data by platform, prompt, and persona

• Competitor analysis for tracked prompts

• Responses API (raw data)

• Full response text from AI platforms
• Individual citations and source URLs
• Detailed competitor mentions and sentiment
• Response-level metadata

These datasets power analytics to understand how AI platforms present your brand versus competitors, where you’re cited, and how sentiment trends over time, so you can quantify the impact of AI on brand visibility.

Authentication and setup

• Create an API key using the “Add API key” button in the API keys section of Settings.
• Scrunch uses bearer token authentication. Tokens can be scoped to a single brand or multiple brands within an organization.
• Example request: curl -H "Authorization: Bearer ${SCRUNCH_API_TOKEN}" \ https://api.scrunchai.com/v1/${BRAND_ID}/query?fields=brand_presence_percentage
• If you encounter authentication errors, confirm the bearer token is active (not expired or revoked) in Settings.

Data collection timing

Scrunch automatically begins collecting responses once you create a brand and add prompts: - Smaller organizations: expect initial data within 20–60 minutes. - Larger organizations: allow up to 12 hours for initial collection.

Billing for API usage

Scrunch bills based on the number of AI responses collected—not API call volume. Costs scale with the number of brands, prompts, and AI platforms you choose to track.

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 tracks brand presence by collecting actual AI responses from all major AI platforms and detecting explicit brand mentions using pattern matching validated against continuously updated response datasets. This approach, combined with 90-day historical coverage, supports reliable measurement across platforms and prompts.

Related resources

• Learn more about the two APIs in the Scrunch API FAQs.
• See the data you can access via each API in the FAQ: What types of data can I access through the Scrunch API?