---
title: "Analiza SERP"
source: https://docs.senuto.com/modules/serp_analysis
---

# 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](/types/filter) · [Paginacja](/types/pagination) · [Błędy i status `418`](/types/errors).

## Model pracy: zadanie → raporty

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

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

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