---
title: "Projekty z rozszerzonymi danymi (`getListWithExtendedData`)"
source: https://docs.senuto.com/modules/rank_tracker/rt-projects-getListWithExtendedData
api: GET /api/rank_tracker/management/projects/getListWithExtendedData
---

# Projekty z rozszerzonymi danymi (`getListWithExtendedData`)

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

Zwraca **listę Twoich projektów Rank Trackera razem ze statystykami** — liczbą monitorowanych fraz, rozkładem pozycji (TOP3 / TOP10 / TOP50), średnią pozycją, widocznością organiczną oraz liczbą wzrostów i spadków. Jedno żądanie zastępuje pobranie listy projektów i osobnego raportu pozycji dla każdego z nich. Zakres obejmuje projekty własne **oraz udostępnione** Twojemu kontu.

---

## Żądanie

`GET` `/api/rank_tracker/management/projects/getListWithExtendedData`

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

**Żądanie**

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

**cURL**

```bash
curl --location --request GET 'https://api.senuto.com/api/rank_tracker/management/projects/getListWithExtendedData?limit=2&page=1' \
  --header 'Authorization: Bearer $YOUR_TOKEN_HERE'
```

### Parametry

```ts
type ProjectsGetListWithExtendedDataRequest = {
/** Liczba projektów na stronę. */
limit?: number;
/** Numer strony. */
page?: number;
/** Sortowanie listy projektów. */
order?: { prop: string; dir: 'ASC' | 'DESC' };
/** Filtry listy projektów. */
filtering?: Array<Record<string, unknown>>;
/** Zawężenie do projektów oznaczonych wskazanymi tagami. Wartość inna niż tablica jest ignorowana. */
tags?: number[];
}
export default ProjectsGetListWithExtendedDataRequest
```

> **Ostrzeżenie:**
> W odpowiedzi są **dwa klucze wykresu**: poprawny `visibility_chart` i **literówka `visiblity_chart`** (brak drugiego `i`). Oba istnieją i zawierają to samo. Czytaj `visibility_chart`, ale nie zdziw się drugim polem.

> **Ostrzeżenie:**
> To metoda **`GET`** — `order`, `filtering`, `tags`, `limit` i `page` przekazuje się w **query stringu**. `tags` przekazane jako wartość inna niż tablica jest po cichu ignorowane.

> **Ostrzeżenie:**
> Lista zawiera także projekty **udostępnione** Twojemu kontu, nie tylko własne — rozróżnisz je polem `project.is_owner`.

## Odpowiedź

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

```json filename="przykładowa-odpowiedź"
{
  "success": true,
  "data": [
    {
      "project": {
        "id": 1234,
        "domain": "example.com",
        "name": "medonet",
        "country_id": "1",
        "region_id": "22440",
        "project_fit_id": "1",
        "status": "1",
        "is_crawled": "1",
        "is_owner": false,
        "last_update": "2026-08-24",
        "tags": []
      },
      "dates": {
        "last_date": {
          "timestamp": 1787529600,
          "formatted": "2026-08-24"
        },
        "previous_data": {
          "timestamp": 1787443200,
          "formatted": "2026-08-23"
        }
      },
      "statistics": {
        "keywords_count": {
          "older_value": "100",
          "recent_value": "100",
          "diff": 0,
          "percent": 0
        },
        "top3": {
          "older_value": 0,
          "recent_value": 0,
          "diff": 0,
          "percent": 0
        },
        "top10": {
          "older_value": 9,
          "recent_value": 8,
          "diff": -1,
          "percent": -0.1111
        },
        "top50": {
          "older_value": 64,
          "recent_value": 67,
          "diff": 3,
          "percent": 0.0469
        },
        "avg_pos": {
          "older_value": 34.89,
          "recent_value": 34.61,
          "diff": -0.28,
          "percent": -0.008
        },
        "organic_visibility": {
          "older_value": 12219,
          "recent_value": 13514,
          "diff": 1295,
          "percent": 0.106
        },
        "wins": {
          "older_value": 19,
          "recent_value": 28,
          "diff": 9,
          "percent": 0.4737
        },
        "lost": {
          "older_value": 31,
          "recent_value": 27,
          "diff": -4,
          "percent": -0.129
        }
      },
      "visibility_chart": [],
      "visiblity_chart": []
    }
  ],
  "pagination": {
    "page_count": 2,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": "4",
    "limit": 2
  }
}
```

### Struktura odpowiedzi

```ts
type ProjectsGetListWithExtendedDataResponse = {
success: boolean;
data: Array<{
  /** Dane projektu: identyfikator, domena, nazwa, kraj, region, dopasowanie, tagi, właściciel. */
  project: Record<string, unknown>;
  /** Data ostatniego pomiaru i pomiaru poprzedniego — każda jako `{ timestamp, formatted }`. */
  dates: {
    last_date: { timestamp: number; formatted: string };
    previous_data: { timestamp: number; formatted: string };
  };
  /** Statystyki projektu: liczba fraz, rozkład pozycji, widoczność, wzrosty i spadki. */
  statistics: {
    keywords_count: number;
    top3: number; top10: number; top50: number; out50: number;
    /** Rozkłady w przedziałach pozycji. */
    '1_3': number; '4_10': number; '11_20': number; '21_50': number;
    avg_pos: number;
    organic_visibility: number;
    organic_potential: number;
    ad_visibility: number;
    ad_potential: number;
    budget: number;
    wins: number; lost: number; no_change: number;
  };
  /** Szereg do wykresu widoczności. */
  visibility_chart: unknown[];
  /** **Literówka w nazwie klucza** — duplikat `visibility_chart`, utrzymywany dla kompatybilności. */
  visiblity_chart: unknown[];
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default ProjectsGetListWithExtendedDataResponse
```

## 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) — lekka lista projektów (`id`, `domain`, `name`).
- [`getMyGroupsInProject`](/modules/rank_tracker/rt-projects-getMyGroupsInProject) — grupy fraz w projekcie.
- [`positions/getData`](/modules/rank_tracker/rt-positions-getData) — pełny raport pozycji projektu.