OTotterly
Competitors

Suggest competitors for a brand

Changed on

Suggests competitors for a brand using AI web search, with name variations and domain variations for each. Nothing is saved. Every item is ready to pass as a competitor to POST /v1/reports/brand or PATCH /v1/reports/brand/{reportId}. The brand own domain is never returned. A 503 means the research failed or timed out and the request is safe to retry.

post/v1/competitors/suggestions

Request

  • Base URL
    https://data.otterly.ai
  • Auth
    HTTP bearer

Request body

brandstring required

Brand name to find competitors for.

brandDomainstring required

Brand website domain, e.g. acme.com.

maxResultsinteger

Optional. Maximum number of competitors to return. Defaults to 10, max 20.

Example request

{
  "brand": "Adidas",
  "brandDomain": "adidas.com",
  "maxResults": 10
}

Response

Suggested competitors.

Example response

{
  "competitors": [
    {
      "brand": "Nike",
      "brandVariations": [
        "nike",
        "Nike Inc."
      ],
      "brandDomain": "nike.com",
      "brandDomainVariations": [
        "nike.de",
        "nike.co.uk"
      ],
      "brandDomainWildcard": false,
      "brandRegex": null
    }
  ]
}

Changes