---
title: "TOP100: utworzenie (`create`)"
source: https://docs.senuto.com/modules/serp_analysis/serp-tool-top100-create
api: POST /api/tasks/management/top100_crawl/create
---

# TOP100: utworzenie (`create`)

> **Błąd:**
> **Endpoint mutujący.** Zużywa jednostkę dziennego limitu narzędzi (`tools_daily_limit`) oraz limit wejściowy `top100_crawl_input_limit` (zależny od liczby fraz) i uruchamia crawl wyników TOP100.

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

Przykładowe żądanie:

```json
{
  "keywords": [
    "buty"
  ],
  "country_id": 1
}
```

Przykładowa odpowiedź:

```json
{
  "success": true,
  "data": {
    "id": 4430394,
    "status": "waiting",
    "country_id": 1,
    "type": "top100_crawl",
    "data": {
      "keywords": [
        "buty"
      ],
      "country_id": 1
    },
    "raw_request": {
      "keywords": [
        "buty"
      ],
      "country_id": 1
    },
    "created": 1783251245,
    "completed": null
  }
}
```

Tworzy **zadanie crawla TOP100** dla listy fraz i zwraca `id`, którego użyjesz w [`check`](/modules/serp_analysis/serp-tool-top100-check) oraz w raportach narzędzia ([getKeywords](/modules/serp_analysis/serp-tool-top100-getKeywords), [getDomains](/modules/serp_analysis/serp-tool-top100-getDomains), [getData](/modules/serp_analysis/serp-tool-top100-getData)). Bezpośrednio po utworzeniu `status = "waiting"` — raporty zwrócą dane po zakończeniu crawla (`completed`).

---

## Żądanie

`POST` `/api/tasks/management/top100_crawl/create`

```jsonc filename="żądanie.jsonc"
{ "keywords": ["buty"], "country_id": 1 }
```

### Parametry

```ts
type Top100CreateRequest = {
/** **Wymagane**. Lista fraz do zbadania (TOP100). */
keywords: string[];
/** **Wymagane**. ID kraju (1 = Polska). */
country_id: number;
}
export default Top100CreateRequest
```

## Odpowiedź

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

## Błędy

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

## Powiązane akcje

- [`top100_crawl/check`](/modules/serp_analysis/serp-tool-top100-check) — status crawla.
- [Limity zapytań](/rate-limits) — `tools_daily_limit`.