Zadanie: utworzenie (create)
Endpoint mutujący. Każde wywołanie zużywa jednostkę dziennego limitu Analizy SERP (serp_analysis_daily_limit) i uruchamia crawl wyników. Zachowaj task_id po swojej stronie — raporty gotowego zadania odpytasz później bez konsumpcji limitu.
/api/tasks/management/serp_analysis/createTworzy zadanie analizy SERP dla pary keyword + country_id i uruchamia crawl wyników wyszukiwania. Zwraca id, którego użyjesz w check (odpytywanie statusu) oraz we wszystkich raportach (reports/*). Bezpośrednio po utworzeniu status = "crawling" i progress.has_serp_data = false — raporty SERP zwrócą dane dopiero, gdy has_serp_data będzie true.
Jeśli identyczne zadanie (ta sama fraza + kraj) już istnieje i jest świeże, backend może zwrócić istniejące zadanie bez ponownego naliczenia limitu.
Żądanie
POST /api/tasks/management/serp_analysis/create
{ "keyword": "obroża dla psa świecąca", "country_id": 1 }Parametry
| Name | Type | Default |
|---|---|---|
keyword | stringWymagane. Fraza (min. 2 znaki). | |
country_id | numberWymagane. ID kraju (baza krajów Senuto; 1 = Polska). |
Odpowiedź
| Name | Type | Default |
|---|---|---|
success | boolean | |
data | { id: number; status: string; country_id: number; is_read: number; type: string; data: { keyword: string; }; raw_request: Record<string, unknown>; created: number; completed: number | null; progress: { ...; }; refreshable: boolean; } |
Błędy
Błędy tego endpointu przychodzą we wspólnej kopercie ze statusem 418.
Powiązane akcje
serp_analysis/check— odpytywanie statusu zadania.- Limity zapytań — dzienny limit
serp_analysis_daily_limit.