Skip to content
TrakkrAPI

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

brandstringrequired

Brand ID from /get-brands

viewstring

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

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.

FieldDescription
promptThe prompt text
top_brandBrand most often in position #1
countTimes 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.

ViewDescription
summaryDefault. Full competitive analysis with rankings and co-occurrences.
arenaAll competitors ranked by share-of-voice.
head-to-headDirect 1v1 comparison. Requires competitor parameter.
by-modelCompetitive breakdown per AI model.
threatsRising/declining competitors and opportunity gaps.

view=arena

Returns all competitors ranked by share-of-voice. Your brand is always included and marked with is_primary: true.

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand=BRAND_ID&view=arena'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "competitors": [
4    {
5      "name": "Notion",
6      "is_primary": true,
7      "total_mentions": 127,
8      "share_of_voice": 34.2,
9      "avg_rank": 2.1,
10      "avg_score": 7.3,
11      "rank_1_count": 42,
12      "trend": "up"
13    },
14    {
15      "name": "Coda",
16      "is_primary": false,
17      "total_mentions": 89,
18      "share_of_voice": 24.0,
19      "avg_rank": 3.4,
20      "avg_score": 5.8,
21      "rank_1_count": 18,
22      "trend": "stable"
23    }
24  ],
25  "total_prompts_analyzed": 45,
26  "analysis_period_days": 90
27}

Arena Competitor

namestring

Brand or competitor name

is_primaryboolean

True if this is your brand

total_mentionsinteger

Total mentions across all models

share_of_voicenumber

Percentage of total mentions (0-100)

avg_ranknumber

Average position when mentioned

avg_scorenumber

Average visibility score (1-10)

rank_1_countinteger

Times ranked #1

trendstring

Trend direction: up, down, stable

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=BRAND_ID&view=head-to-head&competitor=Coda'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "competitor": "Coda",
4  "your_mentions": 127,
5  "competitor_mentions": 89,
6  "cooccurrence_count": 52,
7  "cooccurrence_rate": 40.9,
8  "your_win_rate": 65.4,
9  "your_avg_rank": 2.1,
10  "competitor_avg_rank": 3.8,
11  "prompts_you_win": [
12    {
13      "prompt": "best project management tools 2026",
14      "your_rank": 1,
15      "competitor_rank": 4
16    }
17  ],
18  "prompts_they_win": [
19    {
20      "prompt": "best document collaboration tools",
21      "your_rank": 3,
22      "competitor_rank": 1
23    }
24  ],
25  "model_breakdown": [
26    {
27      "model": "ChatGPT",
28      "your_mentions": 45,
29      "competitor_mentions": 32,
30      "your_win_rate": 71.0
31    }
32  ]
33}
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

competitorstring

Competitor name

cooccurrence_countinteger

Times both appeared in same response

cooccurrence_ratenumber

Co-occurrence as % of your appearances

your_win_ratenumber

Percentage where you ranked higher

prompts_you_winarray

Prompts where you outrank them

prompts_they_winarray

Prompts where they outrank you

model_breakdownarray

Per-model 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=BRAND_ID&view=by-model'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "models": [
4    {
5      "model_name": "ChatGPT",
6      "your_mentions": 45,
7      "your_rank": 2.1,
8      "your_score": 7.3,
9      "top_competitor": "Coda",
10      "top_competitor_mentions": 32,
11      "top_competitor_rank": 3.4,
12      "all_competitors": [
13        { "name": "Coda", "mentions": 32, "avg_rank": 3.4 },
14        { "name": "Confluence", "mentions": 28, "avg_rank": 4.1 }
15      ]
16    },
17    {
18      "model_name": "Perplexity",
19      "your_mentions": 38,
20      "your_rank": 1.8,
21      "your_score": 8.1,
22      "top_competitor": "Confluence",
23      "top_competitor_mentions": 35,
24      "top_competitor_rank": 2.5,
25      "all_competitors": []
26    }
27  ]
28}

Model Performance

model_namestring

AI model name

your_mentionsinteger

Your mention count on this model

your_ranknumber

Your average rank on this model

top_competitorstring

Strongest competitor on this model

top_competitor_mentionsinteger

Top competitor mention count

all_competitorsarray

All competitor stats for this model

view=threats

Returns emerging competitive threats, declining competitors, and opportunity prompts where you are not ranked but competitors are.

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-competitor-data?brand=BRAND_ID&view=threats'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "rising_competitors": [
4    {
5      "name": "Slite",
6      "current_mentions": 18,
7      "previous_mentions": 6,
8      "mention_growth": 200.0,
9      "prompts_gained": ["best team knowledge base", "notion alternatives"],
10      "threat_level": "high"
11    }
12  ],
13  "declining_competitors": [
14    {
15      "name": "Evernote",
16      "current_mentions": 12,
17      "previous_mentions": 28,
18      "mention_growth": -57.1,
19      "threat_level": "low"
20    }
21  ],
22  "opportunity_prompts": [
23    {
24      "prompt_text": "best CRM for startups",
25      "primary_brand_rank_info": "Not Ranked",
26      "highly_ranked_competitors": ["Coda", "Confluence"]
27    }
28  ],
29  "new_entrants": ["Slite", "Taskade"]
30}

Rising Competitor

namestring

Competitor name

current_mentionsinteger

Mentions in current period

previous_mentionsinteger

Mentions in previous period

mention_growthnumber

Growth percentage

prompts_gainedarray

Prompts where they newly appear

threat_levelstring

Threat level: high, medium, low

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=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}
Press ? for keyboard shortcuts