Competitor performance

curl -X GET 'https://api.trakkr.ai/get-competitor-data?brand_id=00000000-0000-4000-8000-81f286d10c3c&view=arena&days=30&limit=10' \
  -H "Authorization: Bearer $TRAKKR_API_KEY"

{
  "prompts": [
    {
      "prompt_text": "best team knowledge base",
      "your_rank": 2,
      "your_score": 2.4,
      "leader": "Coda",
      "leader_score": 1.6,
      "gap_to_leader": 0.8,
      "total_competitors": 6,
      "rankings": [
        { "rank": 1, "name": "Coda", "score": 1.6, "is_you": false },
        { "rank": 2, "name": "Notion", "score": 2.4, "is_you": true }
      ]
    }
  ],
  "total_prompts": 45,
  "prompts_you_lead": 12,
  "prompts_top_3": 31
}

curl -X GET 'https://api.trakkr.ai/get-competitor-data?brand_id=00000000-0000-4000-8000-81f286d10c3c&view=head-to-head&competitor=Coda&days=30&limit=10' \
  -H "Authorization: Bearer $TRAKKR_API_KEY"

{
  "you": {
    "name": "Notion",
    "visibility": 42.5,
    "visibility_change": 3.1,
    "avg_rank": 2.4,
    "rank1_count": 12
  },
  "rival": {
    "name": "Coda",
    "visibility": 36.2,
    "visibility_change": null,
    "avg_rank": 3.1,
    "rank1_count": 8
  },
  "head_to_head": {
    "your_wins": 18,
    "rival_wins": 10,
    "ties": 4,
    "your_win_rate": 0.56,
    "total_matchups": 32
  },
  "where_rival_wins": [
    {
      "prompt_text": "best document collaboration tools",
      "your_rank": 3,
      "rival_rank": 1
    }
  ],
  "where_you_win": [
    {
      "prompt_text": "best project management tools 2026",
      "your_rank": 1,
      "rival_rank": 4
    }
  ],
  "available_rivals": ["Coda", "Confluence", "Slite"]
}

curl -X GET 'https://api.trakkr.ai/get-competitor-data?brand_id=00000000-0000-4000-8000-81f286d10c3c&view=by-model&days=30&limit=10' \
  -H "Authorization: Bearer $TRAKKR_API_KEY"

{
  "llms": ["ChatGPT", "Claude", "Perplexity"],
  "brands": ["Notion", "Coda", "Confluence"],
  "your_brand": "Notion",
  "heatmap": [
    {
      "brand": "Notion",
      "llm": "ChatGPT",
      "visibility": 48.2,
      "avg_rank": 2.4,
      "mentions": 45,
      "is_you": true
    }
  ],
  "insights": [
    { "type": "strength", "llm": "ChatGPT", "message": "You perform best on ChatGPT" }
  ],
  "your_best_llm": "ChatGPT",
  "your_worst_llm": "Gemini"
}

curl -X GET 'https://api.trakkr.ai/get-competitor-data?brand_id=00000000-0000-4000-8000-81f286d10c3c&view=threats&days=30&limit=10' \
  -H "Authorization: Bearer $TRAKKR_API_KEY"

{
  "threats": [
    {
      "competitor": "Coda",
      "severity": "high",
      "pressure_score": 0,
      "win_rate_against_you": 0.61,
      "cooccurrence_count": 32,
      "trend": "gaining",
      "description": "Wins 61% of 32 head-to-head matchups"
    }
  ],
  "opportunities": [
    {
      "prompt_text": "best CRM for startups",
      "your_rank": 0,
      "gap_to_next": 0,
      "next_competitor": "Coda",
      "opportunity_score": 6,
      "category": "comparison"
    }
  ],
  "alerts": [
    {
      "type": "threat",
      "severity": "high",
      "message": "Coda is gaining on comparison prompts",
      "prompt": "best team knowledge base",
      "competitor": "Coda"
    }
  ],
  "summary": {
    "total_threats": 1,
    "critical_threats": 0,
    "high_threats": 1,
    "total_opportunities": 1,
    "high_value_opportunities": 1
  }
}

curl -X GET 'https://api.trakkr.ai/get-competitor-data?brand_id=00000000-0000-4000-8000-81f286d10c3c&view=over_time&days=90&limit=10' \
  -H "Authorization: Bearer $TRAKKR_API_KEY"

{
  "brands": [
    {
      "name": "Notion",
      "is_you": true,
      "rank": 1,
      "visibility": 41.1,
      "data_points": [
        { "date": "2026-05-02", "visibility": 38.2 },
        { "date": "2026-05-09", "visibility": 41.1 }
      ]
    },
    {
      "name": "Coda",
      "is_you": false,
      "rank": 2,
      "visibility": 36.4,
      "data_points": [
        { "date": "2026-05-02", "visibility": 34.9 },
        { "date": "2026-05-09", "visibility": 36.4 }
      ]
    }
  ],
  "period_days": 90,
  "date_range": { "start": "2026-05-02", "end": "2026-07-28" },
  "your_brand": "Notion",
  "data_through": "2026-07-28",
  "filters_applied": {
    "days": 90,
    "tag_ids": [],
    "prompts_in_scope": 42
  }
}

curl -X GET 'https://api.trakkr.ai/get-competitor-data?brand_id=00000000-0000-4000-8000-81f286d10c3c&view=over_time&days=90&tag_ids=00000000-0000-4000-8000-81f286d10c3c&limit=10' \
  -H "Authorization: Bearer $TRAKKR_API_KEY"