Looker Studio Connector (Legacy)

Connector last updated: September 14, 2026 — this release fixes a date-handling bug that could stop charts loading, and adds citation, share-of-voice, and rank fields.Already using it? Refresh your data source to pick up the new fields — the steps are the same for this connector, and your existing dashboards keep working exactly as they are.

We recommend moving to the v2 connector. This legacy connector handles one brand per data source. The Data Studio Connector connects 1–30+ brands in a single data source, adds agent traffic, site map, and signals data, and fetches every brand in parallel with smarter caching — noticeably faster once you are running more than one brand. This page stays supported for existing setups.

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.

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:

Your API key

You can provision a Query-scoped API key from: Scrunch → Organization → Settings → API Keys
A single API key may be scoped to one or many brands. Use narrow scoping when integrating with client-facing dashboards.

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 multi-brand support.

Supported Dimensions and Metrics

This connector covers a single brand and exposes 65 fields from the Scrunch Query API.

Dates (5)

Field	ID	Type
Date	`date`	YEAR_MONTH_DAY
Date Week	`date_week`	YEAR_WEEK
Date Month	`date_month`	YEAR_MONTH
Date Quarter	`date_quarter`	YEAR_QUARTER
Date Year	`date_year`	YEAR

Prompts & audience (9)

Field	ID	Type	Notes
Prompt	`prompt`	TEXT	High cardinality, so it reads well in a table but poorly as a breakdown.
Prompt ID	`prompt_id`	NUMBER	High cardinality, so it reads well in a table but poorly as a breakdown.
Tag	`tag`	TEXT
Prompt Topic	`prompt_topic`	TEXT
Stage	`stage`	TEXT
Branded	`branded`	BOOLEAN
Country	`country`	TEXT
Persona Name	`persona_name`	TEXT
Persona ID	`persona_id`	NUMBER

AI platform (2)

Field	ID	Type	Notes
AI Platform	`ai_platform`	TEXT
AI Platform Search Enabled	`ai_platform_search_enabled`	BOOLEAN

Competitors (3)

Field	ID	Type	Notes
Competitor Name	`competitor_name`	TEXT
Competitor ID	`competitor_id`	NUMBER
Cited Competitor	`cited_competitor_name`	TEXT	The competitor that owns a cited source. Use this instead of Competitor Name when the chart has citation metrics in it — Competitor Name is calculated on a path that cannot produce citation metrics.

Cited sources (7)

Field	ID	Type	Notes
Source URL	`source_url`	URL	High cardinality, so it reads well in a table but poorly as a breakdown.
Citation Domain	`domain`	TEXT	Registered domain of a cited source (e.g. example.com).
Citation Owner	`owner`	TEXT	Who owns the cited domain: brand, competitor or other.
Source Topic	`source_topic`	TEXT	Topic assigned to a cited source’s domain. Only works alongside a citation metric.
Citation Segment	`citation_segment`	TEXT	Citation segment the cited source falls into. Only works alongside a citation metric.
Source Type	`source_type`	TEXT	Ownership class of the cited source: brand, competitor or other.
Source Domain (legacy)	`source_domain`	TEXT	Host of a cited source, www-stripped. Cannot be combined with citation metrics — use Citation Domain instead when charting citations.

Where & how you appear (3)

Field	ID	Type	Notes
Position Bucket	`position_bucket`	TEXT	Where your brand appears inside a response: top, middle or bottom. Responses that don’t mention your brand are excluded from this breakdown.
Sentiment Band	`sentiment_band`	TEXT	How your brand is talked about when mentioned: positive, mixed or negative. Responses that don’t mention your brand are excluded from this breakdown.
Mention Rank	`rank`	NUMBER	In the product this is ‘Mention Rank’. First-occurrence rank of the entity inside a response (1 = mentioned first).

Core metrics (12)

Field	ID	Type	Notes
Responses	`responses`	NUMBER	Total AI responses collected. Additive, so totals are safe.
Unique Prompts	`unique_prompts`	NUMBER	Prompt variants that produced responses. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Mention Rate	`mention_rate`	PERCENT	The share of AI responses whose text mentions your brand by name. This is the current name for what used to be called Brand Presence (%) — same data, same numbers.
Brand Presence (Percent) (legacy)	`brand_presence_percentage`	PERCENT	Legacy — use `Mention Rate`. Same numbers; kept so existing charts keep working.
Positioning Score	`positioning_score`	NUMBER	How prominently your brand appears inside the responses that mention it, 0-100 (top=100, middle=50, bottom=0). This is the current name for what used to be called Brand Position — same data, same numbers.
Brand Position (legacy)	`brand_position_score`	NUMBER	Legacy — use `Positioning Score`. Same numbers; kept so existing charts keep working.
Sentiment Score	`sentiment_score`	NUMBER	How your brand is talked about in the responses that mention it, 0-100 (positive=100, mixed=50, negative=0). This is the current name for what used to be called Brand Sentiment — same data, same numbers.
Brand Sentiment (legacy)	`brand_sentiment_score`	NUMBER	Legacy — use `Sentiment Score`. Same numbers; kept so existing charts keep working.
Brand Mention Share of Voice (%)	`brand_share_of_voice`	PERCENT	In the product this is ‘Mention Share of Voice’. Slices sum to 1 across the tracked set.
Brand Mention Rank	`brand_avg_rank`	NUMBER	In the product this is ‘Mention Rank’. Average first-occurrence rank of your brand.
Brand Unique Prompts	`brand_unique_prompts`	NUMBER	Prompt variants where your brand was mentioned. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Brand Unique Responses	`brand_unique_responses`	NUMBER	Responses that mentioned your brand. Distinct count, so a total across rows double-counts anything appearing in more than one row.

Competitor metrics (6)

Field	ID	Type	Notes
Competitor Mention Rate	`competitor_mention_rate`	PERCENT	The share of AI responses whose text mentions the competitor by name. Current name for what used to be called Competitor Presence (%) — same data.
Competitor Presence (Percent) (legacy)	`competitor_presence_percentage`	PERCENT	Legacy — use `Competitor Mention Rate`. Same numbers; kept so existing charts keep working.
Competitor Mention Share of Voice (%)	`competitor_share_of_voice`	PERCENT	In the product this is ‘Mention Share of Voice’. Slices sum to 1 across the tracked set.
Competitor Mention Rank	`competitor_avg_rank`	NUMBER	In the product this is ‘Mention Rank’. Average first-occurrence rank of the competitor.
Competitor Unique Prompts	`competitor_unique_prompts`	NUMBER	Prompt variants where the competitor was mentioned. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Competitor Unique Responses	`competitor_unique_responses`	NUMBER	Responses that mentioned the competitor. Distinct count, so a total across rows double-counts anything appearing in more than one row.

Citation metrics (18)

Field	ID	Type	Notes
Citation Rate (%)	`citation_rate`	PERCENT	Share of responses that include at least one citation, whoever owns it. A rate on a 0-1 scale.
Brand Citation Rate (%)	`brand_citation_rate`	PERCENT	Share of responses that cite at least one brand-owned domain. A rate on a 0-1 scale.
Competitor Citation Rate (%)	`competitor_citation_rate`	PERCENT	Share of responses that cite at least one competitor-owned domain. Cannot be broken down by Competitor Name or Competitor ID.
Brand Citation Share of Voice (%)	`brand_citation_share_of_voice`	PERCENT	Of responses that cite anything, the share citing a brand-owned domain. A rate on a 0-1 scale.
Competitor Citation Share of Voice (%)	`competitor_citation_share_of_voice`	PERCENT	Of responses that cite anything, the share citing a competitor-owned domain. Cannot be broken down by Competitor Name or Competitor ID.
Citation Count	`citation_count`	NUMBER	Total citation occurrences. A response citing three URLs counts three.
Brand Citation Count	`brand_citation_count`	NUMBER	Citation occurrences resolving to a brand-owned domain. Additive, so totals are safe.
Competitor Citation Count	`competitor_citation_count`	NUMBER	Citation occurrences resolving to a competitor-owned domain. Cannot be broken down by Competitor Name or Competitor ID.
Citation Unique Responses	`citation_unique_responses`	NUMBER	Responses containing at least one citation. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Brand Citation Unique Responses	`brand_citation_unique_responses`	NUMBER	Responses citing at least one brand-owned domain. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Competitor Citation Unique Responses	`competitor_citation_unique_responses`	NUMBER	Responses citing at least one competitor-owned domain. Cannot be broken down by Competitor Name or Competitor ID.
Citation Unique Domains	`citation_unique_domains`	NUMBER	Distinct citation hosts. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Citation Unique Response-Domains	`citation_unique_response_domains`	NUMBER	This is the grain the product’s Citations page composes on, so an Owner or Citation Domain breakdown reconciles with that page exactly. Distinct response/domain pairs — this is what the Citations dashboard donut shows.
Brand Citation Unique Domains	`brand_citation_unique_domains`	NUMBER	Distinct brand-owned citation hosts. Distinct count, so a total across rows double-counts anything appearing in more than one row.
Competitor Citation Unique Domains	`competitor_citation_unique_domains`	NUMBER	Distinct competitor-owned citation hosts. Cannot be broken down by Competitor Name or Competitor ID.
Brand Citation Mention Rate (%)	`brand_citation_mention_rate`	PERCENT	Share of cited pages that name your brand in the page content itself. A rate on a 0-1 scale.
Competitor Citation Mention Rate (%)	`competitor_citation_mention_rate`	PERCENT	Share of cited pages that name a competitor in the page content itself. A rate on a 0-1 scale.
Influence Score	`weighted_index`	NUMBER	Per-source ranking metric combining citation frequency with reach. Requires a Citation Domain or Source URL breakdown in the same chart.

Date dimensions cover the last 90 days only. For weekly charts, keep date filters week-aligned.

To approximate Scrunch’s Competitive Benchmark view, pair Competitor Name with Competitor Mention Share of Voice (%), or chart Brand Mention Share of Voice (%) against it. A single field that reproduces the visualization exactly still doesn’t exist, but share of voice gets close.

Using the Scrunch Looker Studio Template

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

Open the template

Click the template link.

Scrunch Looker Studio Template

Make a copy

In the top-right corner, click the three dots → Make a copy.

Be sure to install the Scrunch Looker Studio Connector prior to copying.

Connect your Scrunch data source

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

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:

Open the hidden chart in your copied template

Edit each metric formula

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.

Resetting Your Connector (If Needed)

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

Open Looker Studio Admin

Visit: https://lookerstudio.google.com/navigation/reporting

Open Data Sources

Click Data Sources in the top navigation.

Remove the Scrunch data source

Find your Scrunch connector → ⋮ → Remove Data Source Pn

This could be named “AI Data Connector.”

Now remove the connector

Click + Create → Data source → Partner Connectors → Scrunch AI. Then ⋮ → Revoke Delete Pn

Reinstall the connector

Use the connector link again: https://lookerstudio.google.com/datasources/create?connectorId=AKfycbzRRK2rRqh1_ujHS313hitMb5PopzgNUS5m5ih6ohI

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.

Get Started

Quickstarts

Guides

Integrations

Looker Studio Legacy Single-Brand Connector

Looker Studio Connector (Legacy)

Install the Scrunch Looker Studio Connector

Install Connector

Authenticate With Your Scrunch API Key

Supported Dimensions and Metrics

Using the Scrunch Looker Studio Template

Scrunch Looker Studio Template

FAQs

Resetting Your Connector (If Needed)

Summary

Flexible Reporting

Blend with GA4

Template-Ready

​Looker Studio Connector (Legacy)

​Install the Scrunch Looker Studio Connector

Install Connector

​Authenticate With Your Scrunch API Key

​Supported Dimensions and Metrics

​Using the Scrunch Looker Studio Template

Scrunch Looker Studio Template

​FAQs

​Resetting Your Connector (If Needed)

​Summary

Flexible Reporting

Blend with GA4

Template-Ready

Looker Studio Connector (Legacy)

Install the Scrunch Looker Studio Connector

Authenticate With Your Scrunch API Key

Supported Dimensions and Metrics

Using the Scrunch Looker Studio Template

FAQs

Resetting Your Connector (If Needed)

Summary