Skip to main content

Looker Studio Documentation and Template

Connect Scrunch to Google Looker Studio using our private Community Connector. This allows you to build dashboards, analyze historical performance, and blend Scrunch metrics with other data sources such as GA4. Hero Pn The connector exposes all standard Scrunch Query API fields, including:
  • Brand presence, position, and sentiment
  • Competitor presence metrics
  • Date, platform, persona, tag, and source dimensions
Once connected, you can create fully custom dashboards or use our pre-built Scrunch Looker Studio template.

Install the Scrunch Looker Studio Connector

The connector is not yet in the public gallery. Install it directly using the link below:

Install Connector

Open the Scrunch AI Looker Studio Connector
This installs the Scrunch AI data source inside Looker Studio for your Google account.

Authenticate With Your Scrunch API Key

During setup, Looker Studio will prompt you for:
  1. Your API key
You can provision a Query-scoped API key from: ScrunchOrganizationSettingsAPI Keys
A single API key may be scoped to one or many brands. Use narrow scoping when integrating with client-facing dashboards.
  1. Your Brand ID
The connector loads data for one brand at a time. To find your brand ID: Open the brand’s dashboard in Scrunch Look at the URL: https://app.scrunchai.com/org/.../b/1234/dashboard Here, 1234 is your Brand ID.
If you need multi-brand dashboards, reach out to Scrunch. We are collecting feedback for expanded multibrand support.

Supported Dimensions and Metrics

Dimensions

The connector aligns with the Scrunch Query API.
NameData TypeSemantic TypeNotes
prompt_idNUMBERNUMBER
promptSTRINGTEXT
date_monthSTRINGYEAR_MONTHLast 90 days of data
date_weekSTRINGYEAR_WEEKLast 90 days, keep filters week-aligned
dateSTRINGYEAR_MONTH_DAYLast 90 days of data
source_urlSTRINGURL
source_typeSTRINGTEXTBrand, Competitor, Other
persona_idNUMBERNUMBER
persona_nameSTRINGTEXT
competitor_idNUMBERNUMBER
competitor_nameSTRINGTEXT
ai_platformSTRINGTEXTChatGPT, Perplexity, Google AI Overviews, Meta, Claude
ai_platform_search_enabledBOOLEANBOOLEAN
tagSTRINGTEXT
brandedBOOLEANBOOLEANWhether prompt includes brand name(s)

Metrics

NameData TypeSemantic TypeNotes
responsesNUMBERNUMBERCount
brand_presence_percentageNUMBERPERCENT
brand_position_scoreNUMBERNUMBERRange: 1–100
brand_sentiment_scoreNUMBERNUMBERRange: 1–100
competitor_presence_percentageNUMBERPERCENTRequires competitor dimension
There is currently no singular metric that recreates the Scrunch Competitive Benchmark visualization. You may create side-by-side charts or blend data sources to approximate the view.

Using the Scrunch Looker Studio Template

To accelerate setup and reporting, Scrunch provides a pre-built template.
1

Open the template

2

Make a copy

In the top-right corner, click the three dotsMake a copy.
Be sure to add install the Scrunch Looker Studio Connector prior to copying.
Copy Pn
3

Connect your Scrunch data source

When prompted, select the Scrunch AI Looker Studio connector you configured earlier.Data Pn
4

Customize your dashboard

You can now modify charts, add filters, or blend additional sources like GA4, CRM data, paid media, and more.

FAQs

How do I compare last week vs. previous week?
Create custom metrics inside Looker Studio using conditional date filters. Example:
  • Last 7 days
  • Same 7 days previous period
  • Month-to-date vs prior month-to-date
Looker Studio supports calculated fields using functions like:
CASE
WHEN DATE_DIFF(CURRENT_DATE(), date, DAY) < 7 THEN brand_presence_percentage
END
Are there limits to dashboard size?
Yes. Looker Studio allows a maximum of 30 concurrent Community Connector queries. Dashboards with more than ~15 Scrunch-powered charts may hit this limit depending on complexity.
How do I recreate the Brand Presence + Competitor Presence chart from the Scrunch dashboard?
A version of this combined view is already included in the Scrunch Looker Studio template. When you make a copy of the template, zoom out on the canvas—you’ll see a hidden chart that mimics the dual-line Brand vs. Competitor Presence visualization from the Scrunch dashboard. Looker Studio does not natively blend these metrics into a single field, so the chart requires custom-calculated metrics under the hood. Each competitor’s presence must be defined using a conditional formula, such as:
CASE WHEN competitor_name = "Competitor A" THEN competitor_presence_percentage END
To customize the benchmark view for your own competitive set:
  1. Open the hidden chart in your copied template
  2. Edit each metric formula
  3. Replace the competitor names with the ones relevant to your brand
There is no universal “competitive benchmark” metric available from the API. The Looker Studio template replicates this view by combining multiple calculated fields inside one chart.
Alt Chart Pn

Resetting Your Connector (If Needed)

If the connector was set up incorrectly, here’s how to completely reset it:
2

Open Data Sources

Click Data Sources in the top navigation.
3

Remove the Scrunch data source

Find your Scrunch connector → ⋮ → RemoveData Source Pn
This could be named “AI Data Connector.”
4

Now remove the connector

Click + Create → Data source → Partner Connectors → Scrunch AI Then ⋮ → RevokeDelete Pn
6

Re-enter your API key and brand ID

You now have a clean state.

Summary

Flexible Reporting

Build dashboards for brand trends, sentiment, competitors, and platform performance.

Blend with GA4

Unify Scrunch visibility metrics with site traffic and conversion data.

Template-Ready

Use our prebuilt Looker Studio template to jumpstart reporting.