---
title: "Fraza: propozycje (`getKeywordsPropositions`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-keyword-getKeywordsPropositions
api: POST /api/serp_analysis/reports/keyword/getKeywordsPropositions
---

# Fraza: propozycje (`getKeywordsPropositions`)

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

Przykładowe żądanie:

```json
{
  "task_id": null,
  "limit": 10,
  "filtering": [
    {
      "filters": [
        {
          "key": "keywords",
          "items": [
            {
              "value": "pies",
              "match": "contain"
            }
          ]
        }
      ],
      "conjunction": "and"
    }
  ]
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "added": "2021-06-02",
      "keyword": "pies",
      "searches": 110000,
      "cpc": 0.92,
      "words_count": 1,
      "kid": "fb2fe71d592fad516f05549409da8e35",
      "cpc_min": 0.08,
      "cpc_max": 1.76,
      "variations_number": 60,
      "snippets": [
        "image_thumbs",
        "video_thumbs",
        "wiki_right"
      ]
    }
  ],
  "pagination": {
    "page_count": 3071,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 30707,
    "limit": 10
  }
}
```

Zwraca **propozycje fraz** do rozbudowy treści wokół badanego tematu — frazy powiązane z metrykami (wyszukiwania, CPC, trend, warianty pisowni `variations`, typy snippetów). Przydatne przy planowaniu contentu pod pełne pokrycie tematyczne.

| Fraza | Wyszukiwania | CPC | CPC min | CPC max | Liczba słów | Warianty | Dodano |
| --- | --- | --- | --- | --- | --- | --- | --- |
| pies | 110000 | 0.92 | 0.08 | 1.76 | 1 | 60 | 2021-06-02 |
| pies sznaucer miniaturowy | 60500 | 0.13 | 0.06 | 0.19 | 3 | 1 | 2021-03-11 |
| berneński pies pasterski | 60500 | 0.1 | 0.08 | 0.13 | 3 | 9 | 2021-06-22 |

_task_id 1579873 „pies”, z filtrem na frazy zawierające „pies”. Wiersze zawierają też trend_1..12, trends[], variations[] i obiekt statistics (w JSON)._

> **Informacja:**
> Obsługuje `filtering` (jak w Bazie słów). `variations` to warianty pisowni frazy. Wymaga `task_id` gotowego zadania.

---

## Żądanie

`POST` `/api/serp_analysis/reports/keyword/getKeywordsPropositions`

```jsonc filename="żądanie.jsonc"
{
  "task_id": null,
  "limit": 10,
  "page": 1,
  // bez filtra ranking schodzi na najpopularniejsze frazy z całego zbioru propozycji,
  // niekoniecznie związane z tematem — filtr trzyma listę przy badanej frazie
  "filtering": [{ "filters": [{ "key": "keywords", "items": [{ "value": "pies", "match": "contain" }] }], "conjunction": "and" }]
}
```

### Parametry

```ts
type SerpKeywordsPropositionsRequest = {
/** **Wymagane**. ID gotowego zadania SERP. Realny `task_id` pobierzesz z `POST /api/tasks/management/serp_analysis/list` albo z odpowiedzi `create`. */
task_id: number;
/** Liczba wierszy na stronę. @default 10 */
limit?: number;
/** Numer strony. @default 1 */
page?: number;
/** Opcjonalne filtry (jak w Bazie słów). */
filtering?: Record<string, unknown>[];
}
export default SerpKeywordsPropositionsRequest
```

## Odpowiedź

```ts
type SerpKeywordsPropositionsResponse = {
success: boolean;
data: Array<{
  added: string;
  keyword: string;
  searches: number;
  cpc: number;
  cpc_min: number | null;
  cpc_max: number | null;
  words_count: number;
  kid: string;
  variations: string[];
  variations_number: number;
  snippets: string[];
  trends: number[];
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default SerpKeywordsPropositionsResponse
```

## Błędy

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

## Powiązane akcje

- [`keyword/getRelatedKeywords`](/modules/serp_analysis/serp-keyword-getRelatedKeywords) — frazy powiązane.
- [`keyword/getQuestions`](/modules/serp_analysis/serp-keyword-getQuestions) — pytania powiązane.