Discover Competitors

Auto-discover competitors using SEO analysis + LLM.

Finds competing domains via keyword overlap and SERP analysis, then creates BrandCompetitor records for each discovery. Returns the list of newly discovered competitors.

POST /api/v1/brands/{brand_id}/competitors/discover

Discover Competitors

cURL

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

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

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