---
title: "Fraza: URL-e · lista wyników (`getList`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-urls-getList
api: POST /api/serp_analysis/reports/urls/getList
---

# Fraza: URL-e · lista wyników (`getList`)

**`POST /api/serp_analysis/reports/urls/getList`**

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "rows": [
      {
        "position": 1,
        "domain": "pl.wikipedia.org",
        "main_domain": "wikipedia.org",
        "url": "https://pl.wikipedia.org/wiki/Pies_domowy",
        "uid": "8c704d3f9fff2c37bde6760a06988343",
        "content": {
          "title": {
            "value": "Pies domowy – Wikipedia, wolna encyklopedia",
            "length": 43
          },
          "description": {
            "value": "",
            "length": 0
          },
          "text2html_ratio": 0.2,
          "length": 39467,
          "headers": {
            "h1": {
              "value": [
                "Pies domowy[edytuj wstęp]"
              ],
              "count": 1
            },
            "h2": {
              "value": [
                "Wstęp",
                "Taksonomia",
                "Budowa i wygląd",
                "Wiek psa",
                "Zmysły psa",
                "Komunikacja niewerbalna psa",
                "Historia i udomowienie",
                "Użytkowość",
                "Choroby genetyczne psów",
                "Wpływ psa na człowieka",
                "Medycyna ludowa",
                "Miejsce chowu psa",
                "Rozmnażanie psów",
                "Psy na znaczkach pocztowych",
                "Zobacz też",
                "Przypisy",
                "Bibliografia",
                "Linki zewnętrzne"
              ],
              "count": 18
            },
            "h3": {
              "value": [
                "Mózg psa",
                "Skóra i sierść psa",
                "Udomowienie",
                "Historia psa domowego na ziemiach polskich"
              ],
              "count": 4
            }
          }
        },
        "keywords": {
          "number": 0
        }
      }
    ],
    "extra": []
  },
  "pagination": {
    "page_count": 2,
    "current_page": 1,
    "has_next_page": true,
    "has_prev_page": false,
    "count": 20,
    "limit": 10
  }
}
```

Zwraca **listę adresów w TOP** dla badanej frazy wraz z analizą treści każdej strony: pozycję, domenę, tytuł i opis (z długościami), stosunek tekstu do HTML (`text2html_ratio`), długość treści oraz nagłówki `h1`/`h2`/`h3` (wartości i liczność). Podstawa analizy konkurencji na poziomie pojedynczych stron.

| Pozycja | Domena | URL | Tytuł | Dł. tytułu | Dł. treści | text/HTML | H1 | H2 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 1 | pl.wikipedia.org | https://pl.wikipedia.org/wiki/Pies_domowy | Pies domowy – Wikipedia, wolna encyklopedia | 43 | 39467 | 0.2 | 1 | 18 |
| 2 | royalcanin.com | https://www.royalcanin.com/pl/dogs/breeds |  | 0 | 0 | 0.1 | 0 | 0 |
| 3 | filmweb.pl | https://www.filmweb.pl/film/Pies-2022-867994 | Pies (2022) - Filmweb | 21 | 569 | 0.07 | 1 | 1 |

_task_id 1579873 „pies”. Wiersze zawierają pełne obiekty content.headers (h1/h2/h3) w JSON._

> **Informacja:**
> Opcjonalne `compare_url_ids` (tablica ID własnych URL-i dodanych przez zarządzanie URL-ami) dokłada je do porównania. Obsługuje `filtering`. `extra` zawiera dane porównywanych URL-i użytkownika. Wymaga `task_id` gotowego zadania.

---

## Żądanie

`POST` `/api/serp_analysis/reports/urls/getList`

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

### Parametry

```ts
type SerpUrlsGetListRequest = {
/** **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>[];
/** ID własnych URL-i do porównania. */
compare_url_ids?: number[];
}
export default SerpUrlsGetListRequest
```

## Odpowiedź

```ts
type SerpUrlsGetListResponse = {
success: boolean;
data: {
  rows: Array<{
    position: number;
    domain: string;
    main_domain: string;
    url: string;
    uid: string;
    content: {
      title: { value: string; length: number };
      description: { value: string; length: number };
      text2html_ratio: number;
      length: number;
      headers: {
        h1: { value: string[]; count: number };
        h2: { value: string[]; count: number };
        h3: { value: string[]; count: number };
      };
    };
    keywords: { number: number };
  }>;
  /** Dane porównywanych URL-i użytkownika (compare_url_ids). */
  extra: unknown[];
};
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default SerpUrlsGetListResponse
```

## Błędy

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

## Powiązane akcje

- [`content/getStatistics`](/modules/serp_analysis/serp-content-getStatistics) — zbiorcze statystyki treści TOP.