Competitor Tools

get_competitors

Get competitors mentioned in AI responses, ranked by mention frequency.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`relationship`	string	No	Filter by type: `SELF`, `DIRECT`, `INDIRECT`, `ECOSYSTEM`
`limit`	number	No	Max competitors to return (default: 20)

Relationship Types

Type	Description
`SELF`	Your own brand
`DIRECT`	Direct competitors (same product category)
`INDIRECT`	Indirect competitors (adjacent solutions)
`ECOSYSTEM`	Ecosystem players (complementary products)

Returns

Field	Type	Description
`id`	string	Competitor domain ID
`name`	string	Competitor name
`domain`	string	Competitor’s domain
`relationship`	string	Relationship type
`mentions`	number	Total mention count
`avgPosition`	number	Average position in responses
`avgSentiment`	number	Average sentiment (0-100)

Example Output

## Competitors for Acme Corp

| Rank | Name | Relationship | Mentions | Avg Position | Sentiment |
|------|------|--------------|----------|--------------|-----------|
| 1 | CompetitorA | DIRECT | 892 | 2.3 | 75/100 |
| 2 | CompetitorB | DIRECT | 654 | 3.1 | 72/100 |
| 3 | Acme Corp | SELF | 612 | 2.8 | 78/100 |
| 4 | CompetitorC | DIRECT | 445 | 4.2 | 68/100 |
| 5 | ToolX | INDIRECT | 234 | 5.1 | 71/100 |

Example Prompts

Who are my competitors in AI responses?

Show me only direct competitors

Which brands appear alongside mine most often?

OAuth Scope

Requires: read:competitors

get_competitor_evolution

Track how a competitor’s presence changes over time — mentions, position, and sentiment trends.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID
`competitorId`	string	Yes	The competitor domain ID (from `get_competitors`)
`period`	number	No	Days to analyze (default: 30)

Returns

Array of daily data points:

Field	Type	Description
`date`	string	Date (YYYY-MM-DD)
`mentions`	number	Mentions on that day
`avgPosition`	number	Average position
`avgSentiment`	number	Average sentiment

Example Output

## CompetitorA - Evolution Over Time

Relationship: DIRECT

| Date | Mentions | Avg Position | Sentiment |
|------|----------|--------------|-----------|
| 2025-01-21 | 28 | 2.5 | 73/100 |
| 2025-01-22 | 31 | 2.3 | 74/100 |
| 2025-01-23 | 35 | 2.1 | 76/100 |
| 2025-01-24 | 29 | 2.4 | 75/100 |
| 2025-01-25 | 38 | 2.0 | 77/100 |

Example Prompts

How has CompetitorA trended over the last month?

Is CompetitorB gaining or losing visibility?

Show me the evolution of my own brand mentions

Use get_competitors first to find the competitorId you want to track.

OAuth Scope

Requires: read:competitors

get_competitor_comparison

Head-to-head comparison of the brand against its top direct competitors: your own stats, your market rank, the top competitors’ stats, a per-competitor win/loss summary on mention count, and the biggest perceived threat.

Parameters

Parameter	Type	Required	Description
`brandId`	string	Yes	The brand ID from `list_brands`
`period`	number	No	Number of days to analyze (default: 30)

Returns

Field	Description
`period` / `periodLabel`	The analyzed window
`yourStats`	Your brand: `name`, `mentionCount`, `avgSentiment`, `avgPosition` (null if not mentioned in the period)
`marketRank`	Your rank across SELF + DIRECT brands by mention count
`totalCompetitors`	Number of direct competitors found
`topCompetitors[]`	Per competitor: `name`, `domain`, `mentionCount`, `avgSentiment`, `avgPosition`
`headToHead[]`	Top 5 matchups: `competitor`, `yourMentions`, `theirMentions`, `winner` (you/them/tie), plus your vs their sentiment and position
`insights`	`winsAgainstTop5`, `lossesAgainstTop5`, `biggestThreat`

Example Prompts

How do I compare to my top competitors right now?

Which competitors am I beating, and which are beating me?

OAuth Scope

Requires: read:competitors

Getting Started

Tools

Examples

Workflows

get_competitors

Parameters

Relationship Types

Returns

Example Output

Example Prompts

OAuth Scope

get_competitor_evolution

Parameters

Returns

Example Output

Example Prompts

OAuth Scope

get_competitor_comparison

Parameters

Returns

Example Prompts

OAuth Scope

​get_competitors

​Parameters

​Relationship Types

​Returns

​Example Output

​Example Prompts

​OAuth Scope

​get_competitor_evolution

​Parameters

​Returns

​Example Output

​Example Prompts

​OAuth Scope

​get_competitor_comparison

​Parameters

​Returns

​Example Prompts

​OAuth Scope

get_competitors

Parameters

Relationship Types

Returns

Example Output

Example Prompts

OAuth Scope

get_competitor_evolution

Parameters

Returns

Example Output

Example Prompts

OAuth Scope

get_competitor_comparison

Parameters

Returns

Example Prompts

OAuth Scope