---
title: "URL crawler: wyniki (`getList`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-tool-urlscrawl-getList
api: POST /api/serp_analysis/tools/urls_crawl/getList
---

# URL crawler: wyniki (`getList`)

**`POST /api/serp_analysis/tools/urls_crawl/getList`**

Przykładowe żądanie:

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

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": [
    {
      "url": "pies.pl",
      "title": "Pies domowy – opis, występowanie i zdjęcia...",
      "title_length": 75,
      "description": "Trudno o bardziej różnorodny gatunek niż pies domowy...",
      "description_length": 377,
      "h1": [
        "Pies domowy – opis, występowanie i zdjęcia..."
      ],
      "h1_count": 1,
      "h2": [
        "Jak pies został przyjacielem człowieka?"
      ],
      "h2_count": 7,
      "content_length": 11611,
      "external_links": [],
      "external_links_count": 0,
      "internal_links": [],
      "internal_links_count": 0
    }
  ],
  "pagination": {
    "page_count": 1,
    "current_page": 1,
    "has_next_page": false,
    "has_prev_page": false,
    "count": 2,
    "limit": 10
  }
}
```

Zwraca **zcrawlowaną treść** wskazanych adresów URL: tytuł i opis (z długościami), nagłówki `h1`/`h2` (wartości i liczność), długość treści oraz linki wewnętrzne i zewnętrzne (z liczbą). Wymaga gotowego zadania [`urls_crawl`](/modules/serp_analysis/serp-tool-urlscrawl-create).

| URL | Tytuł | Dł. tytułu | Dł. opisu | H1 | H2 | Dł. treści | Linki wewn. | Linki zewn. |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| pies.pl | Pies domowy – opis, występowanie i zdjęcia. Zwierzę pies domowy ciekawostki | 75 | 377 | 1 | 7 | 11611 | 0 | 0 |

_Wiersze zawierają pełne tablice h1/h2/linków w JSON._

> **Informacja:**
> `external_links` i `internal_links` to tablice obiektów `{ value: url }`. Wymaga `task_id` gotowego zadania.

---

## Żądanie

`POST` `/api/serp_analysis/tools/urls_crawl/getList`

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

### Parametry

```ts
type UrlsCrawlGetListRequest = {
/** **Wymagane**. ID gotowego zadania urls_crawl. Realny `task_id` zwraca `create` — zapisz go po swojej stronie. */
task_id: number;
limit?: number;
page?: number;
}
export default UrlsCrawlGetListRequest
```

## Odpowiedź

```ts
type UrlsCrawlGetListResponse = {
success: boolean;
data: Array<{
  url: string;
  title: string;
  title_length: number;
  description: string;
  description_length: number;
  h1: string[];
  h1_count: number;
  h2: string[];
  h2_count: number;
  content_length: number;
  external_links: Array<{ value: string }>;
  external_links_count: number;
  internal_links: Array<{ value: string }>;
  internal_links_count: number;
}>;
pagination: {
  page_count: number; current_page: number;
  has_next_page: boolean; has_prev_page: boolean;
  count: number; limit: number;
};
}
export default UrlsCrawlGetListResponse
```

## Błędy

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

## Powiązane akcje

- [Eksport URL crawler (CSV)](/modules/serp_analysis/serp-export-urlscrawl) — eksport tych danych do pliku.
- [`urls_crawl/create`](/modules/serp_analysis/serp-tool-urlscrawl-create) — utworzenie zadania.