---
title: "Grupy fraz w projekcie (`getMyGroupsInProject`)"
source: https://docs.senuto.com/modules/rank_tracker/rt-projects-getMyGroupsInProject
api: GET /api/rank_tracker/management/projects/getMyGroupsInProject
---

# Grupy fraz w projekcie (`getMyGroupsInProject`)

**`GET /api/rank_tracker/management/projects/getMyGroupsInProject`**

Zwraca **grupy fraz zdefiniowane w projekcie** wraz z liczbą fraz w każdej z nich. Identyfikatory grup podaje się dalej jako `group_id` w raportach Monitoringu — to najprostsza droga, by przejść od projektu do konkretnego wycinka fraz.

---

## Żądanie

`GET` `/api/rank_tracker/management/projects/getMyGroupsInProject`

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

**Żądanie**

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

**cURL**

```bash
curl --location --request GET 'https://api.senuto.com/api/rank_tracker/management/projects/getMyGroupsInProject?project_id=87944' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE'
```

### Parametry

```ts
type ProjectsGetMyGroupsInProjectRequest = {
/**
 * **Wymagane w praktyce**. Identyfikator projektu; brak parametru jest interpretowany jako `0`,
 * co zwraca wyłącznie wiersz zbiorczy. Własne projekty pobierzesz z `getMyActiveProjects`.
 */
project_id: number;
}
export default ProjectsGetMyGroupsInProjectRequest
```

> **Ostrzeżenie:**
> **Typ pola `count` jest niespójny.** Wiersz zbiorczy (`id: 0`) ma liczbę, a grupy rzeczywiste — string (`"1"`). Rzutuj na liczbę przed obliczeniami.

> **Ostrzeżenie:**
> Pierwszy wiersz odpowiedzi jest **syntetyczny**: `id: 0` z nazwą „Słowa kluczowe projektu” i sumą fraz ze wszystkich grup. Nie jest to istniejąca grupa — nie przekazuj `0` jako `group_id`, jeśli chcesz konkretną grupę.

> **Ostrzeżenie:**
> Endpoint zwraca wyłącznie grupy **niedynamiczne** należące do Twojego konta w tym projekcie. Brak `project_id` w query nie jest błędem — zwróci pustą listę z samym wierszem zbiorczym.

## Odpowiedź

Przykład to **rzeczywista odpowiedź produkcyjna**, skrócona.

```json filename="przykładowa-odpowiedź"
{
  "success": true,
  "data": [
    {
      "id": 0,
      "name": "Słowa kluczowe projektu",
      "count": 342
    },
    {
      "id": 12345,
      "name": "Kategorie produktowe",
      "count": "128"
    }
  ]
}
```

### Struktura odpowiedzi

```ts
type ProjectsGetMyGroupsInProjectResponse = {
success: boolean;
data: Array<{
  /** Identyfikator grupy. Wartość `0` to wiersz zbiorczy „wszystkie frazy projektu”. */
  id: number;
  name: string;
  /**
   * Liczba fraz w grupie. **Typ niespójny**: dla wiersza zbiorczego (`id: 0`) liczba,
   * dla grup rzeczywistych string.
   */
  count: number | string;
}>;
}
export default ProjectsGetMyGroupsInProjectResponse
```

## Błędy

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

## Powiązane akcje

- [`getMyActiveProjects`](/modules/rank_tracker/rt-projects-getMyActiveProjects) — skąd wziąć `project_id`.
- [`keywords/getGroupKeywords`](/modules/rank_tracker/rt-keywords-getGroupKeywords) — frazy w wskazanej grupie.
- [`groups/list`](/modules/rank_tracker/rt-groups-list) — grupy z pełnymi danymi.