Performance tools

See Filter Compatibility for the authoritative global evidence-filter contract. Those shared parameters apply in addition to the tool-specific parameters shown below.

get_brand_performance

Get mention rate, source rate, share of voice, and sentiment for one brand in a defined evidence scope.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	integer or string	No	Rolling days (1-3650), `"all"`, or `"custom"` with dates; default: 30 days
`startDate`	string	No	Inclusive start date (`YYYY-MM-DD`); provide with `endDate`
`endDate`	string	No	Inclusive end date (`YYYY-MM-DD`); provide with `startDate`
`provider`	string	No	Filter by AI provider (e.g., “openai”, “anthropic”, “perplexity”)
`providers`	string[]	No	AI provider or model IDs; values are ORed
`topic` / `topicId`	string	No	Single-topic aliases using a UUID returned by `list_topics`
`topicIds`	string[]	No	Topic UUIDs; values are ORed
`tag` / `tagId`	string	No	Single-tag aliases using a UUID returned by `list_tags`
`tagIds`	string[]	No	Tag UUIDs; values are ORed
`funnelStages`	string[]	No	Any of `TOFU`, `MOFU`, and `BOFU`; values are ORed
`competitorDomainId`	string	No	SELF competitor-domain UUID returned by `get_competitors`

If no date parameters are provided, the last 30 days are analyzed. Custom startDate and endDate take precedence over period. Topic and tag can be combined with either window and with a provider filter.

Returns

Field	Description
`brand`	Brand ID, name, and domain
`appliedFilters`	Resolved evidence window and taxonomy filters used for the result
`period`	Inclusive analyzed start and end dates
`scores.mentionRate`	SELF-mentioned responses divided by responses mentioning any SELF or DIRECT brand
`scores.sourceRate`	SELF-citing responses divided by responses citing any SELF or DIRECT brand
`scores.shareOfVoice`	SELF mention facts divided by all SELF + DIRECT mention facts
`scores.sentiment`	Average SELF sentiment score (0-100)
`scoreDetails`	Numerator and denominator for mention rate, source rate, and share of voice
`methodology`	Prompt, provider, and response counts inside the filtered evidence scope

Example output

## GEO Performance: Acme Corp

Period: 2026-07-24 to 2026-08-23

### Key metrics
- Mention Rate: 45% (72 / 160 relevant responses)
- Source Rate: 28% (42 / 150 citable responses)
- Share of Voice: 38% (152 / 400 brand mentions)
- Sentiment: 78/100

### Methodology
- 156 monitored prompts
- 8 AI providers
- 2,340 total responses analyzed

Example prompts

What's my GEO score?

Show me performance for the last 30 days

How does my brand perform on ChatGPT?

Compare my performance this month vs last month

Show my share of voice for this tag over the last 30 days

OAuth scope

Requires: read:visibility

get_visibility_trend

Get the brand’s AI visibility as a time series. Returns daily (or weekly) data points so you can see how mention rate, sentiment, and position move over time, plus a computed trend direction (up / down / stable).

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	integer or string	No	Global evidence window; defaults to 30 days
`groupBy`	string	No	Group data points by `day` (default) or `week`

Returns

Field	Description
`period` / `periodLabel`	The analyzed window (e.g. `30d`, “Last 30 days”)
`groupBy`	Whether points are grouped by day or week
`dataPoints[]`	Per point: `date`, `totalAnswers`, `brandMentions`, `sourceCitations`, `visibilityRate` (%), `avgSentiment` (0-100, null if none), `avgPosition` (null if not mentioned)
`trend`	`direction` (up/down/stable), `change`, and a short `description` (first half vs second half of the period)
`summary`	`totalAnswers`, `totalBrandMentions`, `avgVisibility` (%)

Example prompts

How has my visibility changed over the last month?

Show me my weekly visibility trend

OAuth scope

Requires: read:visibility

get_sentiment_trend

Get the brand’s sentiment as a daily time series, with average position and mention rate per day. Use it to spot when AI perception of the brand shifts.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	integer or string	No	Global evidence window; defaults to 30 days

Returns

Field	Description
`period` / `periodLabel`	The analyzed window
`dataPoints[]`	Per day: `date`, `avgSentiment` (0-100, null if none), `avgPosition` (null if not mentioned), `totalAnswers`, `brandMentionRate`
`summary`	`avgSentiment` (0-100), `totalAnswers`, `brandMentionRate` over the whole period

Example prompts

Is sentiment toward my brand improving or declining?

Show me my daily sentiment for the last 90 days

OAuth scope

Requires: read:topics

get_provider_breakdown

Get visibility metrics broken down by AI provider (ChatGPT, Claude, Perplexity, Gemini, Copilot, Grok, etc.). Use it to see which engines the brand is winning or losing on.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	integer or string	No	Global evidence window; defaults to 30 days

Returns

Field	Description
`period` / `periodLabel`	The analyzed window
`providers[]`	Per provider: `provider`, `totalAnswers`, `brandMentions`, `visibilityRate` (%), `avgSentiment` (0-100, null if none), `avgPosition` (null if not mentioned)
`summary`	`totalProviders`, `totalAnswers`, `totalBrandMentions`, `overallVisibility` (%)

Example prompts

Which AI provider mentions my brand the most?

Compare my visibility across ChatGPT, Claude, and Perplexity

OAuth scope

Requires: read:visibility

get_keyword_triggers

Identify which keywords and question types most often trigger brand mentions in AI answers. Returns a trigger rate (% of answers containing that keyword that mention the brand) per keyword and per question type.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	integer or string	No	Global evidence window; defaults to 30 days
`limit`	number	No	Max keywords to return (default: 10)

Returns

Field	Description
`period` / `periodLabel`	The analyzed window
`keywords[]`	Per keyword: `keyword`, `totalAnswers`, `brandMentions`, `triggerRate` (%)
`questionTypes[]`	Per question type: `type`, `totalAnswers`, `brandMentions`, `triggerRate` (%)
`insights`	`bestPerforming`, `needsImprovement`, `totalKeywords`, `avgTriggerRate`

Example prompts

Which keywords trigger my brand most often in AI answers?

What question types am I weakest on?

OAuth scope

Requires: read:visibility

get_topics

Get performance breakdown by topic/keyword to identify strengths and opportunities.

This performance view returns topics with answers in the selected period. Use list_topics for the exhaustive configured topic catalog, including topics without recent answers.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`period`	integer or string	No	Global evidence window; defaults to 30 days
`startDate`	string	No	Start date (YYYY-MM-DD)
`endDate`	string	No	End date (YYYY-MM-DD)
`limit`	number	No	Max topics to return (default: 20)

Returns

Field	Type	Description
`id`	string	Topic/keyword ID
`text`	string	Topic name
`score`	number	Overall topic score (0-100)
`mentionRate`	number	% of responses mentioning brand
`sourceRate`	number	% of responses citing brand
`shareOfVoice`	number	Brand vs competitors for this topic
`promptsCount`	number	Number of prompts for this topic

Example output

## Performance by topic

| Topic | Score | Mention Rate | Source Rate | Share of Voice | Prompts |
|-------|-------|--------------|-------------|----------------|---------|
| Project Management | 78 | 52% | 34% | 42% | 45 |
| Team Collaboration | 71 | 45% | 28% | 38% | 32 |
| Workflow Automation | 65 | 38% | 22% | 31% | 28 |
| Time Tracking | 58 | 32% | 18% | 25% | 21 |

Example prompts

Which topics perform best for my brand?

Where am I weakest in AI visibility?

Show me performance by keyword

OAuth scope

Requires: read:topics

Get started

Tool reference

Examples

Workflows

get_brand_performance

Parameters

Returns

Example output

Example prompts

OAuth scope

get_visibility_trend

Parameters

Returns

Example prompts

OAuth scope

get_sentiment_trend

Parameters

Returns

Example prompts

OAuth scope

get_provider_breakdown

Parameters

Returns

Example prompts

OAuth scope

get_keyword_triggers

Parameters

Returns

Example prompts

OAuth scope

get_topics

Parameters

Returns

Example output

Example prompts

OAuth scope

​get_brand_performance

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

​get_visibility_trend

​Parameters

​Returns

​Example prompts

​OAuth scope

​get_sentiment_trend

​Parameters

​Returns

​Example prompts

​OAuth scope

​get_provider_breakdown

​Parameters

​Returns

​Example prompts

​OAuth scope

​get_keyword_triggers

​Parameters

​Returns

​Example prompts

​OAuth scope

​get_topics

​Parameters

​Returns

​Example output

​Example prompts

​OAuth scope

get_brand_performance

Parameters

Returns

Example output

Example prompts

OAuth scope

get_visibility_trend

Parameters

Returns

Example prompts

OAuth scope

get_sentiment_trend

Parameters

Returns

Example prompts

OAuth scope

get_provider_breakdown

Parameters

Returns

Example prompts

OAuth scope

get_keyword_triggers

Parameters

Returns

Example prompts

OAuth scope

get_topics

Parameters

Returns

Example output

Example prompts

OAuth scope