---
title: "Fraza: liczba konkurentów (`getCompetitorsNumber`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-keyword-getCompetitorsNumber
api: POST /api/serp_analysis/reports/keyword/getCompetitorsNumber
---

# Fraza: liczba konkurentów (`getCompetitorsNumber`)

**`POST /api/serp_analysis/reports/keyword/getCompetitorsNumber`**

Przykładowe żądanie:

```json
{
  "task_id": null
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "competitors_number": 228
  }
}
```

Zwraca **liczbę domen** konkurujących o badaną frazę w wynikach wyszukiwania. Pojedyncza wartość liczbowa — miara nasycenia konkurencją.

---

## Żądanie

`POST` `/api/serp_analysis/reports/keyword/getCompetitorsNumber`

```jsonc filename="żądanie.jsonc"
{ "task_id": null }
```

### Parametry

```ts
type SerpCompetitorsNumberRequest = {
/** **Wymagane**. ID gotowego zadania SERP. Realny `task_id` pobierzesz z `POST /api/tasks/management/serp_analysis/list` albo z odpowiedzi `create`. */
task_id: number;
}
export default SerpCompetitorsNumberRequest
```

## Odpowiedź

```ts
type SerpCompetitorsNumberResponse = {
success: boolean;
data: { competitors_number: number };
}
export default SerpCompetitorsNumberResponse
```

## Błędy

Błędy tego endpointu przychodzą we [wspólnej kopercie ze statusem `418`](/types/errors).

## Powiązane akcje

- [`keyword/getStatistics`](/modules/serp_analysis/serp-keyword-getStatistics) — statystyki frazy.
- [`keyword/getTopicLeaders`](/modules/serp_analysis/serp-keyword-getTopicLeaders) — najczęstsze URL-e w temacie.