---
title: "Szczegóły frazy: liczba konkurentów (`getCompetitorsNumber`)"
source: https://docs.senuto.com/modules/keywords_analysis/ka-keyword-details-getCompetitorsNumber
api: GET /api/keywords_analysis/reports/keyword_details/getCompetitorsNumber
---

# Szczegóły frazy: liczba konkurentów (`getCompetitorsNumber`)

**`GET /api/keywords_analysis/reports/keyword_details/getCompetitorsNumber`**

Zwraca **liczbę domen konkurujących** o podaną frazę. Pojedyncza liczba — najtańszy sposób oceny, jak zatłoczona jest fraza, przed pobraniem pełnych raportów.

Raport odpytujesz **wprost frazą i krajem** — bez wcześniejszego tworzenia zadania w Analizie
SERP. Jedno żądanie zastępuje ścieżkę „utwórz zadanie → sprawdź status → pobierz wynik"
i nie zużywa limitu zadań.

---

## Żądanie

`GET` `/api/keywords_analysis/reports/keyword_details/getCompetitorsNumber`

Nagłówki: `Authorization: Bearer <token>`.
Parametry przekazuje się w **query stringu**.

**Żądanie**

```jsonc filename="żądanie.jsonc"
{
  "keyword": "hamak",
  "country_id": 1
}
```

**cURL**

```bash
curl --location --request GET 'https://api.senuto.com/api/keywords_analysis/reports/keyword_details/getCompetitorsNumber?keyword=hamak&country_id=1' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE'
```

### Parametry

```ts
type KeywordDetailsGetCompetitorsNumberRequest = {
/** **Wymagane**. Fraza kluczowa, dla której pobierany jest raport. Pusty string zwraca `418`. */
keyword: string;
/**
 * **Wymagane**. Identyfikator kraju; musi istnieć w słowniku krajów — nieznana wartość zwraca
 * `418` z komunikatem `Unknown country_id`. Uwaga: `200` jest tu mapowane na `1`.
 * @default 1
 */
country_id: number;
/** Walidowane, ale bez efektu — ta akcja zwraca pojedynczy obiekt bez paginacji. */
page?: number;
/** Walidowane, ale bez efektu — brak paginacji w odpowiedzi. */
limit?: number;
}
export default KeywordDetailsGetCompetitorsNumberRequest
```

> **Ostrzeżenie:**
> To metoda **`GET`** — parametry przekazuje się w **query stringu**. Wysłanie ich w treści żądania kończy się `418`, bo endpoint czyta wyłącznie query.

> **Ostrzeżenie:**
> Zarówno **`keyword`**, jak i **`country_id`** są **wymagane**. Nieznane `country_id` zwraca `418` z `Unknown country_id`, a wartość **`200` jest mapowana na `1`** — dla Polski trafisz więc do bazy 1.0, nie 2.0.

## Odpowiedź

Przykład poniżej to **rzeczywista odpowiedź produkcyjna** dla frazy `hamak` (`country_id: 1`),
skrócona do jednego wiersza.

```json filename="przykładowa-odpowiedź"
{
  "success": true,
  "data": {
    "competitors_number": 6290
  }
}
```

### Struktura odpowiedzi

```ts
type KeywordDetailsGetCompetitorsNumberResponse = {
success: boolean;
data: {
  /** Liczba domen konkurujących o frazę. */
  competitors_number: number;
};
}
export default KeywordDetailsGetCompetitorsNumberResponse
```

## Błędy

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

## Powiązane akcje

Wszystkie poniższe raporty przyjmują tę samą parę `keyword` + `country_id`:

- [`getStatistics`](/modules/keywords_analysis/ka-keyword-details-getStatistics) — zbiorcze statystyki frazy.
- [`getQuestions`](/modules/keywords_analysis/ka-keyword-details-getQuestions) — pytania o frazę.
- [`getKeywordsPropositions`](/modules/keywords_analysis/ka-keyword-details-getKeywordsPropositions) — propozycje fraz.
- [`getRelatedKeywords`](/modules/keywords_analysis/ka-keyword-details-getRelatedKeywords) — frazy powiązane.
- [`getTopicLeaders`](/modules/keywords_analysis/ka-keyword-details-getTopicLeaders) — liderzy tematu.
- [`getGroups`](/modules/keywords_analysis/ka-keyword-details-getGroups) — grupy frazy.