Skip to main content
Get all competitors for the business. Returns a lightweight list suitable for rendering competitor bubbles in the Explore tab.

Example Request

curl -X GET https://searchcompany-main.up.railway.app/api/explore/competitors \
  -H "Authorization: Bearer $TOKEN"

Example Response

{
  "status": "success",
  "competitors": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Nike",
      "url": "https://nike.com",
      "favicon_url": "https://storage.supabase.co/favicons/competitors/abc123.png",
      "source": "auto_discovered"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Adidas",
      "url": "https://adidas.com",
      "favicon_url": "https://storage.supabase.co/favicons/competitors/def456.png",
      "source": "auto_discovered"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Lululemon",
      "url": "https://lululemon.com",
      "favicon_url": "https://storage.supabase.co/favicons/competitors/ghi789.png",
      "source": "user_added"
    }
  ],
  "count": 3
}

Response Fields

FieldTypeDescription
statusstring"success"
competitorsarrayList of competitor summaries
countnumberTotal number of competitors

Competitor Summary Fields

FieldTypeDescription
idstringUnique competitor ID (UUID)
namestringCompany name
urlstringCompany website URL
favicon_urlstringURL to company favicon
sourcestring"auto_discovered" or "user_added"