TOP100: utworzenie (`create`)

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

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

Żądanie

POST /api/tasks/management/top100_crawl/create

żądanie.jsonc


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

Parametry

Name	Type	Default
`keywords`	`string[]` Wymagane. Lista fraz do zbadania (TOP100).
`country_id`	`number` Wymagane. ID kraju (1 = Polska).

Odpowiedź

Name	Type	Default
`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; }`

Błędy

Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.

Powiązane akcje

top100_crawl/check — status crawla.
Limity zapytań — tools_daily_limit.

TOP100: utworzenie (create)