Get Competitor Data

Deep analysis of how you compare to competitors in AI responses.

Requires authentication

60 req/min

Endpoint

GET/get-competitor-data

Returns comprehensive competitive analysis including performance summaries, top spot ownership, and head-to-head comparisons.

Query Parameters

brand_idstringrequired

Brand UUID from /get-brands. The legacy brand alias is also accepted.

viewstring

View mode: summary, arena, head-to-head, by-model, threats, heatmap, over_time

Default: summary

competitorstring

Competitor name (required when view=head-to-head)

This endpoint is rate limited to 60 requests per minute per API key. See the Rate Limits page for handling 429 responses.

Performance Summary

The brand_performance_summary array shows how you and your competitors rank overall. Your brand is always listed first.

Performance Summary

brand_namestring

Brand or competitor name (your brand is always first)

total_mentions_overallinteger

Total mentions in analysis period (90 days)

overall_avg_scorenumber

Average visibility score (1-10 scale)

overall_avg_ranknumber

Average position when mentioned (lower is better)

overall_rank_distributionarray

Breakdown by rank buckets

llm_specific_performance_listarray

Per-model performance

Top Spot Ownership

The top_spot_ownership array shows which brand "owns" the #1 position for each prompt. Use this to identify prompts where competitors dominate.

Field	Description
`prompt`	The prompt text
`top_brand`	Brand most often in position #1
`count`	Times this brand was #1

Head-to-Head

The primary_brand_cooccurrences array shows how you perform when you and a competitor both appear in the same AI response.

Co-occurrence Data

competitor_namestring

Competitor name

cooccurrence_countinteger

Times you both appeared in same response

cooccurrence_rate_percentnumber

Co-occurrence as % of your total appearances

primary_brand_position_above_rate_percentnumber

Percentage where you ranked higher

A primary_wins_pct above 50% means you typically rank higher than that competitor when you both appear. Below 50% means they usually beat you.

View Modes

Use the view parameter to access different competitive analysis views. Omitting it (or passing view=summary) returns the default response above.

View	Description
`summary`	Default. Full competitive analysis with rankings and co-occurrences.
`arena`	Prompt-by-prompt battlegrounds with leaders, gaps, and rankings.
`head-to-head`	Direct 1v1 comparison. Requires `competitor` parameter.
`by-model`	Competitive breakdown per AI model.
`threats`	Competitive threats, opportunity prompts, alerts, and summary counts.

view=arena

Returns prompt-by-prompt battlegrounds. Each prompt includes your rank, the current leader, the gap to that leader, and the top competitor rankings.

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand_id=BRAND_ID&view=arena'

200 OK

1{
2  "prompts": [
3    {
4      "prompt_text": "best team knowledge base",
5      "your_rank": 2,
6      "your_score": 2.4,
7      "leader": "Coda",
8      "leader_score": 1.6,
9      "gap_to_leader": 0.8,
10      "total_competitors": 6,
11      "rankings": [
12        { "rank": 1, "name": "Coda", "score": 1.6, "is_you": false },
13        { "rank": 2, "name": "Notion", "score": 2.4, "is_you": true }
14      ]
15    }
16  ],
17  "total_prompts": 45,
18  "prompts_you_lead": 12,
19  "prompts_top_3": 31
20}

Arena Prompt

prompt_textstring

Prompt being compared

your_rankinteger

Your rank for this prompt

your_scorenumber

Your average rank score when available

leaderstring

Brand leading this prompt

leader_scorenumber

Leader average rank score when available

gap_to_leadernumber

Rank-score gap to the leader

total_competitorsinteger

Competitors found for this prompt

rankingsarray

Top brands for this prompt

view=head-to-head

Returns a direct 1v1 comparison with a specific competitor. The competitor parameter is required and must match a competitor name (case-insensitive).

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand_id=BRAND_ID&view=head-to-head&competitor=Coda'

200 OK

1{
2  "you": {
3    "name": "Notion",
4    "visibility": 42.5,
5    "visibility_change": 3.1,
6    "avg_rank": 2.4,
7    "rank1_count": 12
8  },
9  "rival": {
10    "name": "Coda",
11    "visibility": 36.2,
12    "visibility_change": null,
13    "avg_rank": 3.1,
14    "rank1_count": 8
15  },
16  "head_to_head": {
17    "your_wins": 18,
18    "rival_wins": 10,
19    "ties": 4,
20    "your_win_rate": 0.56,
21    "total_matchups": 32
22  },
23  "where_rival_wins": [
24    {
25      "prompt_text": "best document collaboration tools",
26      "your_rank": 3,
27      "rival_rank": 1
28    }
29  ],
30  "where_you_win": [
31    {
32      "prompt_text": "best project management tools 2026",
33      "your_rank": 1,
34      "rival_rank": 4
35    }
36  ],
37  "available_rivals": ["Coda", "Confluence", "Slite"]
38}

Returns 400 if the competitor parameter is not provided, or 404 if the competitor is not found in your competitive set.

Head-to-Head Result

youobject

Your visibility, average rank, and #1 counts

rivalobject

Selected competitor stats

head_to_headobject

Wins, losses, ties, win rate, and matchup count

where_you_winarray

Prompts where you outrank the rival

where_rival_winsarray

Prompts where the rival outranks you

available_rivalsarray

Competitors available for comparison

view=by-model

Returns competitive performance broken down by AI model (ChatGPT, Perplexity, Gemini, etc.). Useful for identifying which models favor your brand versus competitors.

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand_id=BRAND_ID&view=by-model'

200 OK

1{
2  "llms": ["ChatGPT", "Claude", "Perplexity"],
3  "brands": ["Notion", "Coda", "Confluence"],
4  "your_brand": "Notion",
5  "heatmap": [
6    {
7      "brand": "Notion",
8      "llm": "ChatGPT",
9      "visibility": 48.2,
10      "avg_rank": 2.4,
11      "mentions": 45,
12      "is_you": true
13    }
14  ],
15  "insights": [
16    { "type": "strength", "llm": "ChatGPT", "message": "You perform best on ChatGPT" }
17  ],
18  "your_best_llm": "ChatGPT",
19  "your_worst_llm": "Gemini"
20}

Model Performance

llmsarray

AI models included in the heatmap

brandsarray

Brands included, with your brand first when present

your_brandstring

Your brand name

heatmaparray

Brand/model cells with visibility, rank, mentions, and is_you

insightsarray

Strength and weakness observations by model

your_best_llmstring

Your strongest model by visibility

your_worst_llmstring

Your weakest model by visibility

view=threats

Returns competitive threats, opportunity prompts, alerts, and summary counts.

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand_id=BRAND_ID&view=threats'

200 OK

1{
2  "threats": [
3    {
4      "competitor": "Coda",
5      "severity": "high",
6      "pressure_score": 82.4,
7      "win_rate_against_you": 0.61,
8      "cooccurrence_count": 32,
9      "trend": "gaining",
10      "description": "Wins 61% of 32 head-to-head matchups"
11    }
12  ],
13  "opportunities": [
14    {
15      "prompt_text": "best CRM for startups",
16      "your_rank": 0,
17      "gap_to_next": 0,
18      "next_competitor": "Coda",
19      "opportunity_score": 6,
20      "category": "comparison"
21    }
22  ],
23  "alerts": [
24    {
25      "type": "threat",
26      "severity": "high",
27      "message": "Coda is gaining on comparison prompts",
28      "prompt": "best team knowledge base",
29      "competitor": "Coda"
30    }
31  ],
32  "summary": {
33    "total_threats": 1,
34    "critical_threats": 0,
35    "high_threats": 1,
36    "total_opportunities": 1,
37    "high_value_opportunities": 1
38  }
39}

Threats Result

threatsarray

Competitors pressuring your brand

opportunitiesarray

Prompts where competitors create an opening

alertsarray

Notable competitive events

summaryobject

Counts for threats and opportunities

Use Cases

Identify your strongest and weakest competitive matchups
Find prompts where competitors dominate
Track competitive position over time
Prioritize content efforts based on competitive gaps
Compare performance by AI model with view=by-model
Detect emerging threats with view=threats

Code example

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224'

200 OK

1{
2  "brand_performance_summary": [
3    {
4      "brand_name": "Notion",
5      "total_mentions_overall": 127,
6      "overall_avg_score": 6.2,
7      "overall_avg_rank": 2.8,
8      "overall_rank_distribution": [
9        { "bucket": "Rank 1", "percentage": 25.5, "count": 32 },
10        { "bucket": "Ranks 2-3", "percentage": 35.0, "count": 44 }
11      ],
12      "llm_specific_performance_list": [
13        {
14          "llm_name": "ChatGPT",
15          "total_mentions": 45,
16          "avg_score": 6.5,
17          "avg_rank": 2.4
18        }
19      ]
20    }
21  ],
22  "top_spot_ownership": [
23    {
24      "prompt_text": "What are the best CRM tools for enterprise?",
25      "top_brand": "Notion",
26      "count_of_rank_1_for_top_brand": 15,
27      "all_rank_1_counts_list": [
28        { "brand_name": "Notion", "count": 15 },
29        { "brand_name": "Coda", "count": 8 }
30      ]
31    }
32  ],
33  "primary_brand_cooccurrences": [
34    {
35      "competitor_name": "Coda",
36      "cooccurrence_count": 45,
37      "cooccurrence_rate_percent": 35.4,
38      "primary_brand_position_above_rate_percent": 68.5
39    }
40  ],
41  "opportunity_prompts": [
42    {
43      "prompt_text": "Best CRM for startups",
44      "primary_brand_rank_info": "Not Ranked",
45      "highly_ranked_competitors": ["Coda", "Confluence"]
46    }
47  ],
48  "llm_performance_overview": [
49    {
50      "llm_name": "ChatGPT",
51      "primary_brand_metrics": {
52        "brand_name": "Notion",
53        "avg_rank": 2.4,
54        "avg_score": 6.5,
55        "total_mentions": 45
56      },
57      "competitor_metrics": []
58    }
59  ]
60}

Request

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224'

200 OK

1{
2  "brand_performance_summary": [
3    {
4      "brand_name": "Notion",
5      "total_mentions_overall": 127,
6      "overall_avg_score": 6.2,
7      "overall_avg_rank": 2.8,
8      "overall_rank_distribution": [
9        { "bucket": "Rank 1", "percentage": 25.5, "count": 32 },
10        { "bucket": "Ranks 2-3", "percentage": 35.0, "count": 44 }
11      ],
12      "llm_specific_performance_list": [
13        {
14          "llm_name": "ChatGPT",
15          "total_mentions": 45,
16          "avg_score": 6.5,
17          "avg_rank": 2.4
18        }
19      ]
20    }
21  ],
22  "top_spot_ownership": [
23    {
24      "prompt_text": "What are the best CRM tools for enterprise?",
25      "top_brand": "Notion",
26      "count_of_rank_1_for_top_brand": 15,
27      "all_rank_1_counts_list": [
28        { "brand_name": "Notion", "count": 15 },
29        { "brand_name": "Coda", "count": 8 }
30      ]
31    }
32  ],
33  "primary_brand_cooccurrences": [
34    {
35      "competitor_name": "Coda",
36      "cooccurrence_count": 45,
37      "cooccurrence_rate_percent": 35.4,
38      "primary_brand_position_above_rate_percent": 68.5
39    }
40  ],
41  "opportunity_prompts": [
42    {
43      "prompt_text": "Best CRM for startups",
44      "primary_brand_rank_info": "Not Ranked",
45      "highly_ranked_competitors": ["Coda", "Confluence"]
46    }
47  ],
48  "llm_performance_overview": [
49    {
50      "llm_name": "ChatGPT",
51      "primary_brand_metrics": {
52        "brand_name": "Notion",
53        "avg_rank": 2.4,
54        "avg_score": 6.5,
55        "total_mentions": 45
56      },
57      "competitor_metrics": []
58    }
59  ]
60}