# Scrunch API Docs - [Build with Scrunch](https://developers.scrunch.com/index.md): Use Scrunch APIs, the MCP, or Data Studio integrations to query AI visibility data, automate configuration, and power custom reports. - [Provision an API key](https://developers.scrunch.com/getting-started/authentication.md): Create, scope, and rotate Scrunch API keys at the organization level to authenticate Query, Responses, Configuration, and Agent Traffic requests. - [Query API Quickstart](https://developers.scrunch.com/getting-started/quickstart-query.md): Step-by-step walkthrough for your first Scrunch Query API call to fetch weekly brand presence, sentiment, and AI visibility metrics by platform. - [Responses API Quickstart](https://developers.scrunch.com/getting-started/quickstart-responses.md): Use the Responses API to retrieve full AI answers, citations, sentiment, competitors, and metadata for every Scrunch prompt execution. - [Optimize and Deploy Quickstart](https://developers.scrunch.com/getting-started/quickstart-orchestration.md): Step-by-step guide to submitting pages for AI search audit, content optimization, and AXP deployment using a single Scrunch pipeline API call. - [Load a Data Mart from the Responses API](https://developers.scrunch.com/guides/data-mart-loading.md): Incrementally load response-level data from the Scrunch Responses API, normalize it into fact and dimension tables, and compute metrics in your warehouse. - [Send Agent Traffic via API](https://developers.scrunch.com/guides/agent-traffic-api-integration.md): Forward AI bot traffic logs to Scrunch from any CDN, edge worker, or hosting environment using the custom Agent Traffic ingestion endpoint and JSON or NDJSON. - [Optimize and Deploy Pipeline Lifecycle Guide](https://developers.scrunch.com/guides/orchestration-lifecycle.md): Walk through every stage of the Optimize and Deploy pipeline — submitting URLs, tracking progress, polling status, handling errors, and processing results. - [Install the Scrunch Data Studio Connector (v2)](https://developers.scrunch.com/integrations/data-studio-connector.md): Install and configure the Scrunch Data Studio v2 connector to compare up to 30 brands side by side in Looker Studio and pull in agent traffic data. - [Data Studio Dashboard Templates for Scrunch](https://developers.scrunch.com/integrations/data-studio-templates.md): Copy pre-built Looker Studio dashboards for multi-brand visibility, single-brand performance, and AI agent traffic and connect them to your Scrunch data. - [Troubleshoot the Scrunch Data Studio Connector](https://developers.scrunch.com/integrations/data-studio-troubleshooting.md): FAQs, error fixes, and reset instructions for the Scrunch Data Studio connector covering brand IDs, agent traffic charts, date grouping, and auth issues. - [Looker Studio Legacy Single-Brand Connector](https://developers.scrunch.com/integrations/looker-studio.md): Configure the legacy single-brand Scrunch Looker Studio Community Connector to build dashboards and blend brand visibility metrics with GA4 and other sources. - [Connect Your CDN to Scrunch Agent Traffic](https://developers.scrunch.com/integrations/agent-traffic.md): Stream AI crawler and bot access logs from supported CDNs and hosting platforms into Scrunch Agent Traffic to track which pages AI bots visit and why. - [Scrunch REST API Directory and Authentication](https://developers.scrunch.com/api-reference/introduction.md): Find the right Scrunch REST API for your task, see which key scope each one needs, and authenticate every request with an API key as a Bearer token. - [Query API: Aggregated AI Visibility Metrics](https://developers.scrunch.com/api-reference/query/overview.md): Pull aggregated brand presence, position, sentiment, citation, and competitor metrics across AI platforms and date ranges from Scrunch. - [Query](https://developers.scrunch.com/api-reference/query.md): Query the data API to retrieve aggregated observation data across multiple dimensions and metrics. This endpoint dynamically generates SQL queries based on the requested fields, allowing flexible aggregation for analytics and reporting workflows. - [Structured Query API: Multi-Metric JSON Endpoint](https://developers.scrunch.com/api-reference/query/structured-query.md): POST brand-scoped JSON queries with dimensions, metrics, HAVING thresholds, negated filters, and prior-period or prior-year comparisons. - [Responses API: Raw AI Answers and Citations](https://developers.scrunch.com/api-reference/responses/overview.md): Retrieve every raw AI response Scrunch collects with full text, citations, sentiment, competitor evaluations, persona, and platform metadata. - [List Responses](https://developers.scrunch.com/api-reference/list-responses.md): Returns AI responses (observations) with full evaluation data, citations, and competitor analysis. Each response represents a single AI-generated answer to a tracked prompt. - [Signals API: Detected changes in AI visibility](https://developers.scrunch.com/api-reference/signals/overview.md): Query Scrunch's nightly detection sweep for statistically-tested level changes and trends in AI visibility metrics, with stable signal identity. - [List Signals](https://developers.scrunch.com/api-reference/signals/list-signals.md): List detected signals for a brand — statistically-tested movements (level changes and trends) in AI-visibility metrics, produced by the nightly detection sweep. - [Get Signal](https://developers.scrunch.com/api-reference/signals/get-signal.md): Fetch one signal by ID, including its full narrative (what happened, why it matters, what to do) when available. Returns 404 for IDs that exist but are not user-facing (non-fired or cluster-child rows) — the same population rule as `listSignals`. - [List Signal Anchor Dates](https://developers.scrunch.com/api-reference/signals/list-signal-anchor-dates.md): List recent distinct detection dates (`detected_for_date`) that produced user-facing signals, newest first. Useful for building date pickers or polling for new detection runs — the population matches `listSignals` with default filters, so every returned day has at least one signal. - [List Signal Reactions](https://developers.scrunch.com/api-reference/signals/list-signal-reactions.md): List reactions users have set on this brand's signals, newest first. This is **brand-wide** — it returns every user's reactions, not just the caller's — so an integration can export the team's aggregate feedback. Filter by `fingerprint` to get reactions for one signal identity, or by `reaction` to g… - [Set Signal Reaction](https://developers.scrunch.com/api-reference/signals/set-signal-reaction.md): Set (or replace) the calling user's reaction on a signal. Reactions are keyed on the signal's stable `fingerprint`, so a reaction survives the nightly re-detection of the same underlying issue. - [Clear Signal Reaction](https://developers.scrunch.com/api-reference/signals/clear-signal-reaction.md): Remove the calling user's reaction on a signal's stable identity. Requires a **user token** (JWT); API keys receive 403. - [Agent Traffic API: Monitor AI Bot Crawls](https://developers.scrunch.com/api-reference/agent-traffic/overview.md): Aggregate AI bot and crawler traffic across your sites by date, path, agent source, and bot type to monitor retrieval, training, and indexing activity. - [Get Agent Traffic](https://developers.scrunch.com/api-reference/agent-traffic/get-agent-traffic.md): Retrieve aggregated bot and AI agent traffic data for a specific site. - [Send Custom Agent Traffic Events](https://developers.scrunch.com/api-reference/agent-traffic/post-custom-web-traffic.md): POST AI bot and agent traffic events from any web host, CDN, or edge function to Scrunch using the custom web-traffic ingestion endpoint. - [AI Referrals API: Send traffic from any analytics tool](https://developers.scrunch.com/api-reference/ai-referrals/overview.md): Send daily AI referral traffic from Adobe Analytics, a warehouse or any other analytics tool, and see it in Scrunch's AI Referrals, Explorer and Scrunchie. - [Register AI Referrals Connection](https://developers.scrunch.com/api-reference/ai-referrals/register-ai-referrals-connection.md): Register one of the brand's websites to send AI referral rows for. Rows can only be sent once a connection exists. - [List AI Referrals Connections](https://developers.scrunch.com/api-reference/ai-referrals/list-ai-referrals-connections.md): List AI Referrals push connections registered for this brand. Scope is limited to push connections only — Google Analytics integrations live in a separate system and are not returned here, even though they can block a register call with `409`. - [Disable AI Referrals Connection](https://developers.scrunch.com/api-reference/ai-referrals/disable-ai-referrals-connection.md): Soft-disable a connection. Previously pushed events are retained but further pushes are rejected with `410 Gone` and the dashboard stops reading from this connection. - [Push AI Referrals Events](https://developers.scrunch.com/api-reference/ai-referrals/push-ai-referrals-events.md): Push a batch of pre-aggregated daily AI-referral events for a registered connection. - [Create Collection Request](https://developers.scrunch.com/api-reference/create-collection-request.md): Triggers on-demand collection for a prompt across the specified AI platforms. Each platform will be queried and the response evaluated independently. - [Site Optimization API: Recommendations, by type and by page](https://developers.scrunch.com/api-reference/site-optimization/overview.md): List a brand's optimization recommendations grouped by best practice or per page, with projected site-score lift, plus the optimization run behind any one page. - [List Recommendation Types](https://developers.scrunch.com/api-reference/site-optimization/list-recommendation-types.md): List a brand's optimization recommendations grouped by type — one row per best practice, with the projected site-score lift (`site_impact_pp`), how many pages it touches (`page_count`), and where those pages sit in the pipeline (`pending`/`reviewed`/`staged`/`deployed` counts). - [Get Recommendation Type Detail](https://developers.scrunch.com/api-reference/site-optimization/get-recommendation-type-detail.md): One recommendation type's detail: the whole-type header (projected lift and per-state page counts) plus one paginated window of its affected pages, each with its pipeline `state` and the before/after content chunks inline. - [List Page Recommendations](https://developers.scrunch.com/api-reference/site-optimization/list-page-recommendations.md): List the latest recommendations per page for a brand — each page's AI-visibility scores, the recommendations to improve it (in the `opportunities` field), and what it already does well (`strengths`). - [Get Page Optimization Detail](https://developers.scrunch.com/api-reference/site-optimization/get-page-optimization-detail.md): Fetch the latest optimization run for one page: a summary of how many content blocks were transformed / enriched / removed, the optimized token total, and every block's before/after content. - [Apply Page Optimization](https://developers.scrunch.com/api-reference/site-optimization/apply-page-optimization.md): Record that a page's optimization was **acted on off-platform** — for when the change was made outside Scrunch (e.g. in Sitecore), so no Scrunch review is needed. - [Audit Scores API: Retrievability and citability by page](https://developers.scrunch.com/api-reference/audit-scores/overview.md): Read a brand's AI-visibility scores — retrievability and citability — rolled up for the whole site and broken out per page, with the headroom left on each. - [Get Site Audit Score](https://developers.scrunch.com/api-reference/audit-scores/get-site-audit-score.md): The brand's site-level AI-visibility score — retrievability and citability rolled up across the whole site (the same numbers the Site Optimization header shows), when it was scored (`generated_at`), the previous run's score for a delta, and `headroom` (the projected site score per metric if every su… - [List Page Audit Scores](https://developers.scrunch.com/api-reference/audit-scores/list-page-audit-scores.md): The latest AI-visibility score per page for a brand — retrievability and citability, each page's `url`, when it was scored (`generated_at`), its headroom (open work by severity), and the sitemap page it maps to (`mapped_page_id`, null when unmatched). - [Crawl Readiness API: Check AI Crawler Access to a Site](https://developers.scrunch.com/api-reference/crawl-readiness/overview.md): Read whether AI crawlers can reach your brand's domains: robots.txt status, bot blocking, client-side rendering, and which pages robots.txt blocks. - [Get AI Crawl Readiness](https://developers.scrunch.com/api-reference/crawl-readiness/get-ai-crawl-readiness.md): Whether AI crawlers can reach one of the brand's domains, based on the brand's most recent finished crawl of it. These are the same signals the AI Access card shows in the Scrunch dashboard. - [Agent Pages Force Refresh: Update Pages on Demand](https://developers.scrunch.com/api-reference/agent-pages/force-refresh-overview.md): Refetch Agent Pages from your live site now and republish them without waiting for the next scheduled check. - [Force Refresh](https://developers.scrunch.com/api-reference/agent-pages/force-refresh.md): Refetch existing Agent Pages from your live site now, then re-optimize and republish them, whether or not they changed. Use it after updating pages on your site so AI agents see the new version without waiting for the next scheduled check. - [Agent Pages Unpublish: Stop Serving Pages on Demand](https://developers.scrunch.com/api-reference/agent-pages/unpublish-overview.md): Take Agent Pages off the edge now and keep them off, without waiting for the next scheduled check. - [Unpublish](https://developers.scrunch.com/api-reference/agent-pages/unpublish.md): Stop serving Agent Pages now. Each path is added to the site's Ignore List, so it stays unpublished through later crawls, sitemap checks and page selections, and its copy is removed from the edge within minutes, or before the response with `immediate: true`. - [Agent Pages Publish: Add Pages on Demand](https://developers.scrunch.com/api-reference/agent-pages/publish-overview.md): Make pages Agent Pages now, including pages your sitemap doesn't list, without waiting for scheduled discovery. - [Publish](https://developers.scrunch.com/api-reference/agent-pages/publish.md): Make pages Agent Pages now, including pages your sitemap doesn't list. Each path is fetched from your live site, optimized and served once that finishes, usually within minutes. On a page-by-page setup each page is selected for Agent Pages and counts against your Agent Pages budget. On a page-by-pag… - [AXP Unpublish API: Take Optimized Pages Off the Edge](https://developers.scrunch.com/api-reference/axp/unpublish.md): Remove curated (Adaptive) AXP pages from the edge on demand and retire them so no re-stage, redeploy, or rollback brings them back. Not for Agent Pages. - [Unpublish Optimized Pages](https://developers.scrunch.com/api-reference/axp-render/unpublish-optimized-pages.md): Removes the curated (Adaptive) content at each path, including edits made in the Agent Pages content editor. It does not remove the Agent Page generated from the live site, which keeps serving at that path. A path with no curated content returns `not_found`; sites below AXP engine 2.1.0 are refused… - [Configuration API: Manage Brands and Prompts](https://developers.scrunch.com/api-reference/configuration/overview.md): Create brands, manage competitors and personas, and configure tracking prompts via the Scrunch Configuration API to automate client onboarding. - [List Brands](https://developers.scrunch.com/api-reference/list-brands.md): List available brands - [List Sites](https://developers.scrunch.com/api-reference/agent-pages/list-sites.md): List the brand's sites. A domain can have more than one row, and each route accepts only some of them: pass the `id` with `agent_pages_active: true` to the Agent Pages force refresh, and the one with `agent_traffic_active: true` to agent traffic. - [Create Brand](https://developers.scrunch.com/api-reference/create-brand.md): Create a new brand - [Update Brand](https://developers.scrunch.com/api-reference/update-brand.md): Partially update a brand. Only fields included in the request body are modified. For competitors and personas, the provided list represents the full desired state: include an `id` to update an existing record, omit `id` to create a new one, and any existing records not in the list are archived. When… - [List Competitors](https://developers.scrunch.com/api-reference/list-competitors.md): List competitors for a brand - [Get Competitor](https://developers.scrunch.com/api-reference/get-competitor.md): Get a competitor by ID - [Create Competitor](https://developers.scrunch.com/api-reference/create-competitor.md): Create a new competitor - [Update Competitor](https://developers.scrunch.com/api-reference/update-competitor.md): Update a competitor - [Archive Competitor](https://developers.scrunch.com/api-reference/archive-competitor.md): Archive a competitor - [List Personas](https://developers.scrunch.com/api-reference/list-personas.md): List personas for a brand - [Get Persona](https://developers.scrunch.com/api-reference/get-persona.md): Get a persona by ID - [Create Persona](https://developers.scrunch.com/api-reference/create-persona.md): Create a new persona - [Update Persona](https://developers.scrunch.com/api-reference/update-persona.md): Update a persona - [Archive Persona](https://developers.scrunch.com/api-reference/archive-persona.md): Archive a persona. Its active prompts are paused (not archived): collection stops but their collected history stays available on the API, and they can be resumed after the persona is restored or the prompts reassigned. - [List Prompts](https://developers.scrunch.com/api-reference/list-prompts.md): Returns a paginated list of prompts for the specified brand, including their variants, tags, and topics. Defaults to active prompts; pass `status=paused` for paused prompts, `status=archived` for archived prompts, or `status=all` to include active, paused, and archived prompts. - [Create Prompt](https://developers.scrunch.com/api-reference/create-prompt.md): Creates a new prompt with variants for the specified platforms. Requires the `configure` scope. - [Update Prompt Status](https://developers.scrunch.com/api-reference/update-prompt-status.md): Pauses or resumes a prompt. Requires the `configure` scope. - [Archive Prompt](https://developers.scrunch.com/api-reference/archive-prompt.md): Archives a prompt (soft delete). The prompt will no longer be tracked but historical data is preserved. Requires the `configure` scope. - [Account API: Read the Subscription State of an API Key](https://developers.scrunch.com/api-reference/account/overview.md): Check whether the account behind a Scrunch API key is on a trial, actively paying, or churned, and read its plan and current billing period. - [Get Account Status](https://developers.scrunch.com/api-reference/account/get-account-status.md): Get the subscription state of the account this API key belongs to. Use `status` to tell a trial from a paid or churned account: `trialing` means the account is in its trial, and `current_period_end` is the date that trial ends. `subscription_not_found` means the account has no Stripe subscription on… - [Webhooks: Pipeline Stage Completion Callbacks](https://developers.scrunch.com/api-reference/webhooks/overview.md): Subscribe to real-time webhook callbacks for Optimize and Deploy pipeline events including audit, optimization, and AXP deployment completion. - [Site Audit API: Score pages for AI search readiness](https://developers.scrunch.com/api-reference/site-audit/overview.md): Queue page audits for URLs on your brand's domain and fetch the AI search readiness checks, scores, and previews that power the Site Audit stage. - [Create Page Audits](https://developers.scrunch.com/api-reference/create-page-audits.md): Create one or more page audits - [List Page Audits](https://developers.scrunch.com/api-reference/list-page-audits.md): List page audits in reverse chronological order - [Get Page Audit](https://developers.scrunch.com/api-reference/get-page-audit.md): Get a specific page audit by ID - [Sitemap API: Pages, Audit Scores, AI Metrics](https://developers.scrunch.com/api-reference/sitemap/overview.md): List, inspect, and export pages from your brand's sitemap with audit scores, citations, AI referrals, and bot traffic metrics for each URL. - [List Sitemap Pages](https://developers.scrunch.com/api-reference/sitemap/list-sitemap-pages.md): List pages discovered in the brand's sitemap with their title, description, depth, audit score, priority flag, and optimized-content flag. - [Get Sitemap Page](https://developers.scrunch.com/api-reference/sitemap/get-sitemap-page.md): Get detailed information about a single page in the brand's sitemap, including title, description, depth, audit score, canonical URL, last-indexed timestamp, priority flag, and optimized-content flag. - [Get Sitemap Page Metrics](https://developers.scrunch.com/api-reference/sitemap/get-sitemap-page-metrics.md): Return time-series performance metrics for a single page: citations, AI referrals, and AI agent traffic. Each metric is reported as a list of buckets keyed by date, with counts broken down by AI platform. - [Export Sitemap Pages](https://developers.scrunch.com/api-reference/sitemap/export-sitemap-pages.md): Download every page matching the supplied filters as CSV or XLSX. Uses the same filters as the list endpoint but skips pagination. - [AXP Render API: Queue Optimized Page Renders](https://developers.scrunch.com/api-reference/axp/overview.md): Queue asynchronous render jobs that fetch, sanitize, and persist pages on your AXP site so optimized content is ready to deploy from one API call. - [Bulk Render Optimized Pages](https://developers.scrunch.com/api-reference/axp-render/bulk-render-optimized-pages.md): Queue render jobs for a list of paths on a registered AXP site. Each path is fetched, sanitized, and persisted as an AXP optimized page asynchronously, so the endpoint returns immediately with one job entry per input path. - [Optimize and Deploy Pipeline API Overview](https://developers.scrunch.com/api-reference/orchestration/overview.md): Run a single async pipeline to audit pages, optimize content for AI search visibility, and deploy results to AXP with polling or webhooks. - [Create Optimize And Deploy Pipeline](https://developers.scrunch.com/api-reference/orchestration/create-optimize-and-deploy-pipeline.md): Create an orchestrated pipeline: audit pages, optimize content, and deploy to AXP - [Get Pipeline Status](https://developers.scrunch.com/api-reference/orchestration/get-pipeline-status.md): Get the status of an optimize-and-deploy pipeline by token - [Meet Scrunchie](https://developers.scrunch.com/mcp/overview.md): Connect your Scrunch data to Claude, ChatGPT, and other AI assistants. Ask questions in plain English and get answers from your live data. - [Connect your AI tool to the Scrunch MCP](https://developers.scrunch.com/mcp/setup.md): Step-by-step setup to connect the Scrunch MCP server to Claude, ChatGPT, Grok, and other AI tools using OAuth in 5 minutes. - [Scrunch MCP Feature Reference and Example Prompts](https://developers.scrunch.com/mcp/tools.md): Reference for 51 Scrunch MCP tools covering reporting, signals, responses, prompts, brand configuration, agent traffic, and help docs, with example prompts. - [Scrunch Agent Skills](https://developers.scrunch.com/mcp/skills/overview.md): Install Scrunch's Agent Skills — MCP-based or REST-only — for brand setup, prompt libraries, dashboards, page audits, and more. - [Switch from Another AI Visibility Tool in One Conversation](https://developers.scrunch.com/mcp/workflows/switch-from-another-tool.md): MCP workflow to migrate brands, personas, tags, competitors, and your full prompt library from another AI visibility tool into Scrunch in one chat. - [New Brand Live in One Conversation](https://developers.scrunch.com/mcp/workflows/new-brand-live.md): MCP workflow that onboards a brand end to end: creates the brand, adds competitors, and seeds a tagged prompt library from one chat with your AI agent. - [Bulk Prompt Import from a Spreadsheet](https://developers.scrunch.com/mcp/workflows/bulk-prompt-import-from-sheets.md): Read a spreadsheet of seed queries, tags, and personas you already have and bulk-create them as tracked Scrunch prompts in one conversation. - [Weekly AI Brief, Saved to Notion or Google Docs](https://developers.scrunch.com/mcp/workflows/weekly-ai-brief.md): One prompt pulls this week's visibility data, saves a full brief to Notion or Google Docs, and posts the headline numbers to Slack. - [Monthly Client Report, Built Automatically](https://developers.scrunch.com/mcp/workflows/monthly-client-report.md): Pull a month's worth of visibility data and have Claude write, structure, and save a complete report to Notion — ready to share or drop into a deck. - [Auto-Build a QBR Deck](https://developers.scrunch.com/mcp/workflows/qbr-deck-builder.md): Turn a brand's presence, position, sentiment, and citation metrics into a formatted quarterly business review deck in Google Slides or PowerPoint. - [Draft a Stakeholder Email Update](https://developers.scrunch.com/mcp/workflows/stakeholder-email-update.md): Pull this period's AI visibility headlines from Scrunch and have Claude draft a stakeholder email update, staged for your review before sending. - [Executive Explorer Dashboard](https://developers.scrunch.com/mcp/workflows/executive-explorer-dashboard.md): Assemble a saved Scrunch Explorer dashboard covering presence, position, sentiment, and citations in one conversation, and get a shareable link back. - [Competitor Share of Voice, Ranked](https://developers.scrunch.com/mcp/workflows/competitor-share-of-voice.md): Rank every tracked competitor by how often they appear in AI responses, find where they're displacing you, and surface the specific prompts to reclaim. - [Live Competitor Tracker Spreadsheet](https://developers.scrunch.com/mcp/workflows/competitor-tracker-spreadsheet.md): Build a spreadsheet of share-of-voice by competitor that you re-run on a cadence to append each period's snapshot into a running trend tab. - [Competitive Battlecard Generator](https://developers.scrunch.com/mcp/workflows/competitive-battlecard.md): Build a per-competitor AI visibility battlecard covering wins, gaps, and talking points, saved to Notion or Google Docs for sales enablement. - [Find Visibility Gaps Worth Fixing](https://developers.scrunch.com/mcp/workflows/find-visibility-gaps.md): MCP workflow to surface your weakest AI visibility topics, identify the specific prompts you're losing, and ship a prioritized content action plan to Notion. - [Where Search Rankings and AI Presence Diverge](https://developers.scrunch.com/mcp/workflows/search-vs-ai-gaps.md): MCP workflow that joins Google Search Console queries with Scrunch data to find pages ranking in search but missing from AI responses, your top-ROI fixes. - [Build an AI Content Brief from Keyword Rankings](https://developers.scrunch.com/mcp/workflows/keyword-rankings-to-ai-brief.md): Combine Semrush or Ahrefs keyword rankings with Scrunch citation gaps to prioritize which content to create or fix and what it must say to get cited. - [Build Your Prompt Library from SEO Keywords](https://developers.scrunch.com/mcp/workflows/prompts-from-keywords.md): Compare your SEO keyword list against existing Scrunch prompts, cluster the gaps, and create new tracking prompts in one conversation. - [Create Content That Gets AI Citations](https://developers.scrunch.com/mcp/workflows/create-content-for-citations.md): Use Scrunch citation gaps to identify what to write, generate content optimized for AI retrieval, and publish it through your CMS — all in one workflow. - [Content Brief Handoff to Design](https://developers.scrunch.com/mcp/workflows/content-brief-to-design.md): Turn a Scrunch visibility gap into a structured content brief and hand it to your design or content team as a FigJam board, ready to move into layout. - [GSC Query-Gap Prompt Expansion](https://developers.scrunch.com/mcp/workflows/gsc-query-gap-expansion.md): Find Google Search Console queries you already rank for that aren't tracked as Scrunch prompts yet, and bulk-create prompts for the top gaps. - [Measure AI Visibility's Impact on Traffic](https://developers.scrunch.com/mcp/workflows/ai-visibility-traffic-impact.md): Pair Google Analytics with Scrunch after lifting AI presence on a topic to confirm whether traffic followed and build the ROI case for AI visibility work. - [Stage Content Tasks for Review](https://developers.scrunch.com/mcp/workflows/content-task-handoff.md): MCP workflow that turns a Scrunch content gap into a fully-briefed Linear, Jira, GitHub, or Asana ticket for the teammate who owns publishing. - [Agent Traffic to a Spreadsheet Dashboard](https://developers.scrunch.com/mcp/workflows/agent-traffic-to-spreadsheet.md): Export Scrunch's AI bot crawl data as CSV and turn it into a pivoted, chartable spreadsheet showing GPTBot, ClaudeBot, and PerplexityBot activity over time. - [Citation Wins Tied to Pipeline](https://developers.scrunch.com/mcp/workflows/citation-wins-to-pipeline.md): Match newly-won AI citations and prompt visibility against your CRM's open deals to show which AI visibility gains are touching active revenue. - [Weekly Visibility Alert to Slack](https://developers.scrunch.com/mcp/workflows/weekly-visibility-alert-slack.md): Compare this week's presence, position, sentiment, and citation metrics to last week, and post a flagged alert to Slack when a threshold is crossed. - [Which Cited Pages Actually Convert](https://developers.scrunch.com/mcp/workflows/landing-page-citation-impact.md): Cross-reference the specific pages AI engines are citing against Google Analytics conversion data to see which citations are driving more than just traffic. - [Configuration & Maintenance](https://developers.scrunch.com/mcp/prompts/configuration.md): Audit your Scrunch setup, find duplicate prompts, check platform coverage, standardize tags, and clean up stale configuration with conversational MCP prompts. - [Brand Presence & Visibility](https://developers.scrunch.com/mcp/prompts/visibility-overview.md): Starter MCP prompts that calculate your AI visibility score and establish where your brand stands across tracked prompts, platforms, and reporting cycles. - [Platform-Specific Analysis](https://developers.scrunch.com/mcp/prompts/platform-analysis.md): MCP prompts that compare brand visibility on ChatGPT, Perplexity, Gemini, and Google AI Overviews to find which platform is underperforming and why. - [Rankings & Priority Lists](https://developers.scrunch.com/mcp/prompts/rankings.md): MCP prompts that return ranked top-10 and bottom-10 lists of best performing prompts, biggest missed opportunities, and weakest topic areas for triage. - [Sentiment Signals](https://developers.scrunch.com/mcp/prompts/sentiment-signals.md): MCP prompts that go beyond the presence question to check how AI assistants actually talk about your brand — positive, mixed, or negative — and why. - [Visibility Gaps & Content Opportunities](https://developers.scrunch.com/mcp/prompts/visibility-gaps.md): MCP prompts that find topics where your brand is absent from AI responses, rank gaps by urgency, and group them into actionable content opportunities. - [White Space & Growth Opportunities](https://developers.scrunch.com/mcp/prompts/white-space.md): MCP prompts that surface uncontested AI search territory — queries where neither you nor competitors appear yet, ranked by first-mover value. - [Citation Analysis](https://developers.scrunch.com/mcp/prompts/citation-analysis.md): Find which pages AI is citing from your site, which topic areas get skipped, and which third-party sources are driving your mentions. - [Trends & Alerts](https://developers.scrunch.com/mcp/prompts/trends-and-alerts.md): MCP prompts that frame metrics over time — what changed since last period, what's been quietly sliding, and what's crossed a threshold worth flagging. - [Competitive Intelligence](https://developers.scrunch.com/mcp/prompts/competitive-intel.md): MCP prompts to rank competitors by AI share of voice, identify where rivals are displacing your brand, and surface positions you need to protect in AI search. - [Reporting Digests](https://developers.scrunch.com/mcp/prompts/reporting.md): MCP prompts that generate structured monthly digests, QBR slides, client call prep docs, and onboarding briefs ready to drop into a presentation. - [Visualize It](https://developers.scrunch.com/mcp/prompts/visualize-it.md): MCP prompts that turn a metric question directly into a Scrunch Explorer chart or saved dashboard, using generate_explorer_chart and create_explorer_dashboard. ## OpenAPI Specs - [openapi](/api-reference/openapi.json) ## Optional - [Status](https://status.scrunchai.com) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.