---
title: "GET /v1/projects/{project_id}/competitors"
method: GET
path: "/v1/projects/{project_id}/competitors"
tags: ["competitors"]
---

# GET /v1/projects/{project_id}/competitors

`GET /v1/projects/{project_id}/competitors`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/competitors`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Response `200`

Successful Response

- Competitor[]
  - `id` string, uuid, required
  - `name` string, required
  - `aliases` string[], required
  - `domains` string[], required
  - `logo_url` string, nullable
  - `matching` EntityMatching
    - `mode` 'always' | 'context_required', required
    - `context_terms` string[], required
    - `exclusion_phrases` string[], required
    - `common_word` boolean, required

---

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