---
title: "URL crawler: utworzenie (`create`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-tool-urlscrawl-create
api: POST /api/tasks/management/urls_crawl/create
---

# URL crawler: utworzenie (`create`)

> **Błąd:**
> **Endpoint mutujący.** Zużywa jednostkę dziennego limitu narzędzi (`tools_daily_limit`) oraz limit wejściowy `urls_crawls_tool_input_limit` (zależny od liczby URL-i) i uruchamia crawl treści wskazanych adresów.

**`POST /api/tasks/management/urls_crawl/create`**

Przykładowe żądanie:

```json
{
  "urls": [
    "senuto.com"
  ],
  "country_id": 1
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "id": 4430395,
    "status": "waiting",
    "country_id": 1,
    "type": "urls_crawl",
    "data": {
      "urls": [
        "senuto.com"
      ]
    },
    "raw_request": {
      "urls": [
        "senuto.com"
      ],
      "country_id": 1
    },
    "created": 1783251369,
    "completed": null
  }
}
```

Tworzy **zadanie crawla treści** wskazanych adresów URL i zwraca `id`, którego użyjesz w [`check`](/modules/serp_analysis/serp-tool-urlscrawl-check) oraz w [`getList`](/modules/serp_analysis/serp-tool-urlscrawl-getList). Crawler pobiera tytuł, opis, nagłówki, długość treści i linki każdej strony.

---

## Żądanie

`POST` `/api/tasks/management/urls_crawl/create`

```jsonc filename="żądanie.jsonc"
{ "urls": ["senuto.com"], "country_id": 1 }
```

### Parametry

```ts
type UrlsCrawlCreateRequest = {
/** **Wymagane**. Lista adresów URL do zcrawlowania. */
urls: string[];
/** **Wymagane**. ID kraju (1 = Polska). */
country_id: number;
}
export default UrlsCrawlCreateRequest
```

## Odpowiedź

```ts
type UrlsCrawlCreateResponse = {
success: boolean;
data: {
  id: number;
  status: string;
  country_id: number;
  type: string;
  data: { urls: string[] };
  raw_request: Record<string, unknown>;
  created: number;
  completed: number | null;
};
}
export default UrlsCrawlCreateResponse
```

## Błędy

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

## Powiązane akcje

- [`urls_crawl/check`](/modules/serp_analysis/serp-tool-urlscrawl-check) — status crawla.
- [`urls_crawl/getList`](/modules/serp_analysis/serp-tool-urlscrawl-getList) — wyniki crawla.