---
title: "Suggest competitors"
method: POST
path: "/v3/settings/brand/suggest-competitors"
tags: ["Settings"]
---

# Suggest competitors

`POST /v3/settings/brand/suggest-competitors`

## Request

- Base URL: `https://api.snowseo.com`
- URL: `https://api.snowseo.com/v3/settings/brand/suggest-competitors`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Suggests competitors with AI from the brand description or website, excluding the ones passed in.

## Request body

- object
  - `teamId` string
  - `excludeCompetitors` object[]
    - `name` string
    - `website` string

## Response `200`

Default Response

- object
  - `success` boolean
  - `data` object
    - `competitors` object[]
      - `id` string
      - `name` string
      - `website` string
      - `active` boolean
      - `ignored` boolean
      - `updatedAt` string
      - `mentionCount` integer
      - `promptCount` integer

## Changes

- **2026-10-03** `3976341798f4`: 1 breaking, 2 info
  - added required request body
  - api tag `Settings` added
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/settings/brand/suggest-competitors/post.md)

---

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