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

# Fraza: pytania (`getQuestions`)

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

Przykładowe żądanie:

```json
{
  "task_id": null,
  "limit": 10
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "keyword": "półpasiec objawy",
      "searches": 33100,
      "cpc": 0.01,
      "cpc_min": 0.01,
      "cpc_max": 0.01,
      "words_count": 2,
      "added": "2021-06-22",
      "kid": "9903e4549ad179b86cec430b4c582910",
      "variations_number": 2,
      "snippets": [
        "question",
        "featured_answer"
      ]
    }
  ],
  "pagination": {
    "page_count": 17289,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 51865,
    "limit": 10
  }
}
```

Zwraca **pytania** powiązane z tematem badanej frazy — frazy pytające z metrykami (wyszukiwania, CPC, trend, warianty, snippety). Podstawa pod sekcje FAQ i treści odpowiadające na intencje użytkowników.

| Pytanie / fraza | Wyszukiwania | CPC | Liczba słów | Warianty | Dodano |
| --- | --- | --- | --- | --- | --- |
| półpasiec objawy | 33100 | 0.01 | 2 | 2 | 2021-06-22 |
| jak narysowac kotka | 22200 | 0 | 2 | 1 | 2021-06-22 |
| ile kolan ma pies | 18100 | 0 | 3 | 0 | 2023-10-02 |

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

> **Informacja:**
> Zestaw pytań zależy od frazy — dla niektórych zadań lista bywa pusta. Obsługuje `filtering`. Wymaga `task_id` gotowego zadania.

---

## Żądanie

`POST` `/api/serp_analysis/reports/keyword/getQuestions`

```jsonc filename="żądanie.jsonc"
{ "task_id": null, "limit": 10, "page": 1 }
```

### Parametry

```ts
type SerpQuestionsRequest = {
/** **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. */
filtering?: Record<string, unknown>[];
}
export default SerpQuestionsRequest
```

## Odpowiedź

```ts
type SerpQuestionsResponse = {
success: boolean;
data: Array<{
  keyword: string;
  searches: number;
  cpc: number;
  cpc_min: number;
  cpc_max: number;
  words_count: number;
  added: string;
  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 SerpQuestionsResponse
```

## Błędy

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

## Powiązane akcje

- [`keyword/getKeywordsPropositions`](/modules/serp_analysis/serp-keyword-getKeywordsPropositions) — propozycje fraz.
- [`keyword/getGroups`](/modules/serp_analysis/serp-keyword-getGroups) — grupy tematyczne.