Skip to main content

Scrunch Metrics Reference: Explorer Names and API Fields

Every Explorer metric, breakdown and filter, with the API field it maps to and what it measures.

Scrunch names the same measurement in two places: the Explorer picker, which is what you click, and the API field name, which is what you receive back from the Query API. This page lists both for every metric, so a number you see in the product and a number you pull programmatically are always the same number.

Pick a metric in Explorer by its metric first, then its aggregation. The API field name is what the Query API returns for that pair.


Metrics

Every metric available in the Explorer picker, with the API field it resolves to for your own brand. Competitor and sub-brand variants follow the same naming, swapping the brand_ prefix for competitor_ or sub_brand_.

Mention

In Explorer, pick

API field

What it measures

Mentions Rate

brand_presence_percentage

Name-mention rate (0-1): share of responses whose text mentions the brand by name (same detection for brand and competitors, directly comparable). Citations of the brand's domain do NOT count. Use brand_citation_rate for that.

Mentions Total Responses

brand_unique_responses

Distinct responses mentioning the brand by name.

Mentions Unique Prompts

brand_unique_prompts

Distinct prompts with at least one response mentioning the brand by name.

Sentiment

In Explorer, pick

API field

What it measures

Sentiment Average

brand_sentiment_score

Sentiment score (0-100) for the brand, over responses that mention it: positive=100, mixed=50, negative=0.

Position

In Explorer, pick

API field

What it measures

Position Average

brand_position_score

Positioning score (0-100) for the brand, over responses that mention it: top=100, middle=50, bottom=0.

Rank

In Explorer, pick

API field

What it measures

Rank Average

brand_avg_rank

Average first-occurrence mention rank of the brand (1 = mentioned first; lower is better), over ranked appearances only.

Citation

In Explorer, pick

API field

What it measures

Citations Rate

brand_citation_rate

Share of responses (0-1) citing at least one source URL owned by the brand. Domain-based; independent of whether the brand is mentioned by name.

Citations Share of Voice

brand_citation_share_of_voice

Of responses that cite anything, share (0-1) citing a source owned by the brand.

Citations Total

brand_citation_count

Total citations of sources owned by the brand.

Citations Unique Responses

brand_citation_unique_responses

Distinct responses citing a source owned by the brand.

Citations Unique Domains

brand_citation_unique_domains

Distinct cited hosts owned by the brand (www-stripped).

Citation Mention Rate

In Explorer, pick

API field

What it measures

Citation Mention Rate

brand_citation_mention_rate

Share of cited URLs whose PAGE CONTENT mentions the brand (denominator = distinct cited URLs). Not the response-text mention rate.

Influence Score

In Explorer, pick

API field

What it measures

Influence Score

entity-agnostic

Influence Score only computes alongside a breakdown. Without one the chart returns no data.

Share of voice

In Explorer, pick

API field

What it measures

Share of Voice

brand_share_of_voice

Mention Share of Voice (0-1): the brand's mentioning responses over the total across the tracked set. Slices sum to 1 (a normalized pie).

Total Responses

In Explorer, pick

API field

What it measures

Total Responses

entity-agnostic

Unique Prompts

In Explorer, pick

API field

What it measures

Unique Prompts

entity-agnostic

Unique Prompts only computes alongside a breakdown. Without one the chart returns no data.


Breakdowns

A breakdown splits a metric into one series per value. You can apply up to 3 at once.

Breakdown

API dimension

What it splits by

Platform

ai_platform

AI platform display name (OpenAI, Claude, Gemini, Perplexity, Microsoft Copilot, Google AI Overview, Google AI Mode, Meta, Grok).

Stage

stage

Customer-journey stage display name.

Persona

persona_name

Persona name.

Topic

prompt_topic

Prompt topic name.

Prompt

prompt

Prompt text.

Competitor

competitor_name

Competitor name (for mention metrics; see cited_competitor_name for citations).

Citation Domain

domain

Cited domain (source grain; only valid alongside citation metrics).

Citation Source Owner

owner

Cited-source owner partition: brand, competitor, or other.

Citation URL

source_url

Cited source URL (source grain; highest cardinality, one bucket per URL).

Citation Segment

citation_segment

Brand-configured citation segment name (plus 'Unsegmented').

Domain Topics

source_topic

Topic tag of the cited source's domain (source grain; 'Untagged' when absent).

Content Delivery Status

content_delivery_status

Whether AXP is currently serving optimized content for the cited page. Four buckets, checked in order: 'na_third_party' (the cited page isn't the brand's own site at all), 'control_group' (manually excluded as a deliberate baseline, technically also not-optimized, tracked separately; wins over 'optimized' if both apply), 'optimized' (AXP-deployed), or 'not_optimized' (the brand's own page, neither of the above).

Sub-brand

sub_brand_id

Sub-brand ID.

Country

country

Geography (country code).

Tag

tag

Prompt tag.

Position bucket

position_bucket

Where the brand appears within the response: top, middle, or bottom.

Sentiment band

sentiment_band

Brand sentiment band of the response: positive, mixed, negative, or none.

Rank

rank

First-occurrence mention rank within the response (integer; 1 = mentioned first).


Filters

Filters narrow the responses a metric is computed over. You can apply up to 8 at once.

Filter

API dimension

What it filters on

Platform

ai_platform

AI platform display name (OpenAI, Claude, Gemini, Perplexity, Microsoft Copilot, Google AI Overview, Google AI Mode, Meta, Grok).

Stage

stage

Customer-journey stage display name.

Branded query

branded

Whether the prompt names the brand (boolean; 'false' selects non-branded prompts).

Sub-brand type

ownership

Sub-brand ownership scope ('own' / 'competitor'), usable in filters[] only; scopes sub_brand_* metrics.

Search enabled

ai_platform_search_enabled

Whether the platform ran with web search enabled (boolean).

Position bucket

position_bucket

Where the brand appears within the response: top, middle, or bottom.

Sentiment band

sentiment_band

Brand sentiment band of the response: positive, mixed, negative, or none.

Persona

persona_name

Persona name.

Topic

prompt_topic

Prompt topic name.

Prompt

prompt_id

Prompt ID.

Country

country

Geography (country code).

Tag

tag

Prompt tag.

Competitor

competitor_name

Competitor name (for mention metrics; see cited_competitor_name for citations).

Source Type

source_type

Cited source ownership class: brand, competitor, or other.

Citation Segment

citation_segment_id

Citation segment ID, usable in filters[] only, not as a breakdown.

Citation URL

source_url

Cited source URL (source grain; highest cardinality, one bucket per URL).

Citation domain

domain

Cited domain (source grain; only valid alongside citation metrics).

Filter values that read differently in the API

A few filter options are labelled for readability in the product and stored under a different value. When you filter through the API, send the stored value.

Filter

Shown in Explorer

Sent to the API

Platform

ChatGPT

OpenAI

Platform

Copilot

Microsoft Copilot

Platform

Meta AI

Meta

Branded query

Branded

true

Branded query

Unbranded

false

Sub-brand type

Brand

own

Search enabled

Search-enabled

true

Search enabled

Model-only

false

Sentiment band

Unclear

none

Source Type

Maps card

map

Source Type

Shopping card

shopping


Limits

  • Up to 5 metrics in one view.

  • Up to 3 breakdowns at once.

  • Up to 8 filters at once.


Metrics available through the API only

These are returned by the Query API but are not in the Explorer picker, usually because they aggregate across every tracked entity rather than one you select.

API field

What it measures

responses

Total responses (count of distinct observations).

unique_prompts

Distinct prompts with at least one response.

citation_rate

Share of responses (0-1) citing at least one source URL of any owner. Domain-based; independent of whether any tracked entity is mentioned by name.

citation_count

Total citations of sources of any owner.

citation_unique_responses

Distinct responses citing a source of any owner.

citation_unique_domains

Distinct cited hosts of any owner (www-stripped).

citation_unique_response_domains

Distinct (response, domain, owner) triples citing a source of any owner. A response citing one domain under 4 URLs counts once, but a response citing 6 domains counts 6. The legacy Citations page's composition grain, so an owner or domain breakdown reconciles with that page exactly. Only meaningful alongside a domain-grain dimension: under a source_url or source_topic breakdown the rows fan out and slices no longer sum to this total.

weighted_index

Influence Score for a cited source: (citations of the source / total citations in the group) x distinct prompts citing it. Only meaningful with a domain or source_url breakdown; entity-agnostic.

Did this answer your question?