---
title: "Suggest competitors for a brand"
method: POST
path: "/v1/competitors/suggestions"
tags: ["Competitors"]
---

# Suggest competitors for a brand

`POST /v1/competitors/suggestions`

## Request

- Base URL: `https://data.otterly.ai`
- URL: `https://data.otterly.ai/v1/competitors/suggestions`
- Auth: HTTP bearer

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.

## Request body

- PublicApiCompetitorResearchRequest
  - `brand` string, required: Brand name to find competitors for.
  - `brandDomain` string, required: Brand website domain, e.g. `acme.com`.
  - `maxResults` integer: Optional. Maximum number of competitors to return. Defaults to 10, max 20.

## Response `200`

Suggested competitors.

- PublicApiCompetitorResearchResponse
  - `competitors` PublicApiBrandCompetitor[], required
    - `brand` string, required: Competitor brand name.
    - `brandVariations` string[], required
    - `brandDomain` string, required
    - `brandDomainVariations` string[], required
    - `brandDomainWildcard` boolean, required
    - `brandRegex` string, nullable, required: Regular expression used to detect the brand in AI answers, instead of `brand` and `brandVariations`. `null` when not set.

## Other responses

- `400`: Validation failed.
- `401`: Unauthorized.
- `403`: Forbidden.
- `429`: Quota exhausted.
- `503`: Competitor research failed or timed out. Safe to retry.

## Changes

- **2026-11-03** `b5dc4bea6d45`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/otterly/apis/otterly-public-api/changes/v1/competitors/suggestions/post.md)

---

[API](https://skmtc.dev/otterly/apis/otterly-public-api.md) - [All operations](https://skmtc.dev/otterly/apis/otterly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/otterly/apis/otterly-public-api/revisions/333e3100f0b4?raw)