Skip to main content

Purpose

Returns a lightweight list of all competitors for the Explore tab bubble visualization. Includes both auto-discovered and user-added competitors.

Architecture

Response Format

{
  "status": "success",
  "competitors": [
    {
      "id": "uuid-...",
      "name": "Competitor A",
      "url": "https://competitor-a.com",
      "favicon_url": "https://...",
      "source": "auto_discovered"
    },
    {
      "id": "uuid-...",
      "name": "Competitor B",
      "url": "https://competitor-b.com",
      "favicon_url": null,
      "source": "user_added"
    }
  ],
  "count": 2
}

Source Types

SourceDescription
auto_discoveredFound during onboarding via Exa
user_addedManually added by user
own_businessThe user’s own business (for comparison)

Code Location

src/app/apis/explore/list_competitors/routes.py