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

# Fraza: grupy (`getGroups`)

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

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "group": "dla psa",
      "keywords_sum": 29661
    },
    {
      "group": "u psa",
      "keywords_sum": 10599
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 10,
    "limit": 10
  }
}
```

Zwraca **grupy tematyczne** fraz powiązanych z badaną frazą — klastry semantyczne z liczbą przypisanych fraz (`keywords_sum`). Ułatwia zaplanowanie struktury treści wokół podtematów.

| Grupa | Liczba fraz |
| --- | --- |
| dla psa | 29661 |
| u psa | 10599 |
| dla psów | 7475 |
| z psem | 4456 |
| karma dla | 4019 |

_task_id 1579873 „pies”._

---

## Żądanie

`POST` `/api/serp_analysis/reports/keyword/getGroups`

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

### Parametry

```ts
type SerpGroupsRequest = {
/** **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 SerpGroupsRequest
```

## Odpowiedź

```ts
type SerpGroupsResponse = {
success: boolean;
data: Array<{
  group: string;
  keywords_sum: number;
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default SerpGroupsResponse
```

## 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/getTopicLeaders`](/modules/serp_analysis/serp-keyword-getTopicLeaders) — liderzy tematu.