Analiza SERP

Moduł Analiza SERP bada wyniki wyszukiwania (TOP) dla wybranej frazy: strony w rankingu, ich treść i nagłówki, statystyki konkurencji oraz powiązane frazy i pytania. Wymaga tokena Bearer, dostępu do API oraz modułu Analiza SERP w planie (systemModuleKey: serp_analysis).

Wspólne mechanizmy: Filtrowanie · Paginacja · Błędy i status 418.

Model pracy: zadanie → raporty

W przeciwieństwie do raportów odpytywanych wprost, Analiza SERP działa asynchronicznie przez obiekt zadania (task):

Utwórz zadanie — serp_analysis/create dla pary keyword + country_id. Zwraca id zadania i uruchamia crawl SERP. Zużywa jednostkę dziennego limitu (serp_analysis_daily_limit).
Poczekaj aż gotowe — odpytuj serp_analysis/check aż progress.has_serp_data = true.
Pobieraj raporty — wszystkie raporty (reports/*) przyjmują task_id gotowego zadania i zwracają dane. Zadanie niegotowe → błąd walidacji Unfinished task.

Ścieżki zarządzania zadaniem są w przestrzeni tasks/management (/api/tasks/management/serp_analysis/...), a raporty w serp_analysis/reports/....