List Competitors

Return merged competitor list — SEO-discovered rows + brand-kit names.

Each entry is tagged with source so the UI can distinguish full-data rows (starrable, editable) from name-only kit chips. Dedup uses fuzzy name matching; see competitor_merge_service.

GET /api/v1/brands/{brand_id}/competitors

List Competitors

cURL

curl --request GET \
  --url https://api.example.com/api/v1/brands/{brand_id}/competitors \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "brand_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "website_url": "<string>",
    "description": "<string>",
    "notes": "<string>",
    "is_starred": false,
    "social_links": {},
    "analysis_data": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "source": "seo_discovery"
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id · string<uuid> · required

Response

200

application/json

Successful Response

brand_id · string<uuid> · required

name · string · required

id · string<uuid> | null

website_url · string | null

description · string | null

notes · string | null

is_starred · boolean · default: false

social_links · Social Links · object

analysis_data · Analysis Data · object

created_at · string<date-time> | null

updated_at · string<date-time> | null

source · enum<string> · default: seo_discovery

Available options: seo_discovery, brand_kit