> ## Documentation Index
> Fetch the complete documentation index at: https://bisibility.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Competitors

> Manage the competitor domains tracked for a project.

Paths are relative to `/api/v1`. All routes use a project-scoped API key -
`Authorization: Bearer <api_key>` - that must belong to the project in the
path. See [Authentication](/docs/docs/authentication) for scopes.

| Method   | Path                                                 | Purpose                                               |
| -------- | ---------------------------------------------------- | ----------------------------------------------------- |
| `GET`    | `/projects/{project_id}/competitors`                 | List managed competitors.                             |
| `POST`   | `/projects/{project_id}/competitors`                 | Add a competitor domain and label.                    |
| `DELETE` | `/projects/{project_id}/competitors/{competitor_id}` | Remove a competitor through the project-scoped route. |
| `DELETE` | `/competitors/{competitor_id}`                       | Remove the same resource through the short route.     |

Competitor metrics are derived from rank-check results. Adding a competitor does
not trigger a provider request by itself.

The generated [OpenAPI document](/docs/api/v1/openapi.json) remains the
authoritative request and response schema.