Przegląd SERP

API + MCP

GET/v3/serp-overview/serp-overview

Parametry zapytania

selectstringWymagane

Lista kolumn do zwrócenia, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

keywordstringWymagane

Słowo kluczowe, dla którego ma zostać zwrócony przegląd SERP.

countrystringWymagane

Dwuliterowy kod kraju (ISO 3166-1 alpha-2).

Dozwolone wartości:adaeafagaialamaoarasatauawazba…

datestring (date-time)

Znacznik czasu, dla którego zwracany jest ostatni dostępny przegląd SERP, w formacie YYYY-MM-DDThh:mm:ss. Jeśli nie zostanie podany, zwracany jest najnowszy przegląd SERP.

top_positionsinteger

Liczba najwyższych organicznych pozycji w SERP do zwrócenia. Jeśli nie zostanie podana, zwrócone zostaną wszystkie dostępne pozycje.

typestring

Lista typów funkcji SERP rozdzielonych przecinkami, według których należy filtrować. Zwracane są tylko pozycje, których type zawiera co najmniej jedną z podanych wartości. Jeśli nie określono, zwracane są pozycje wszystkich typów.

Dozwolone wartości:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

outputstring

Format wyjściowy.

Dozwolone wartości:jsonphpxml

Odpowiedzi

positionsarray<object>

ahrefs_rankinteger or null

Siła profilu linków zwrotnych domeny w porównaniu z innymi witrynami w naszej bazie danych, gdzie pozycja #1 oznacza najsilniejszy profil.

backlinksinteger or null

Całkowita liczba linków z innych witryn prowadzących do wyniku wyszukiwania.

domain_ratingnumber (float) or null

Siła profilu linków zwrotnych domeny w porównaniu z innymi domenami w naszej bazie danych w 100-punktowej skali.

keywordsinteger or null

Łączna liczba słów kluczowych, na które pozycjonuje wynik wyszukiwania w pierwszej setce pozycji organicznych.

page_typestring or null

Rozdzielana przecinkami lista hierarchicznych ścieżek typu strony przewidywanych przez AI dla strony rankingowej. Każda wartość to ścieżka poprzedzona ukośnikiem (np. /Article/How_to).

positioninteger

Pozycja wyniku wyszukiwania w SERP.

refdomainsinteger or null

(5 jednostek) Całkowita liczba unikalnych domen linkujących do wyniku wyszukiwania.

titlestring or null

Tytuł strony w rankingu.

top_keywordstring or null

Słowo kluczowe generujące największy ruch organiczny do wyniku wyszukiwania.

top_keyword_volumeinteger or null

(10 jednostek) Szacunkowa średnia miesięczna liczba wyszukiwań dla najlepszego słowa kluczowego w ciągu ostatnich 12 miesięcy dostępnych danych.

trafficinteger or null

(10 jednostek) Szacunek miesięcznego ruchu organicznego z wyszukiwarek, jaki dany wynik uzyskuje ze wszystkich słów kluczowych, na które się pozycjonuje.

typearray<string>

Rodzaj pozycji: organiczna, płatna lub funkcja SERP.

Dozwolone wartości:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

update_datestring (date-time)

Data sprawdzania wyników wyszukiwarki dla słowa kluczowego.

urlstring or null

Adres URL strony w rankingu.

url_ratingnumber (float) or null

Siła profilu linków zwrotnych strony w 100-punktowej skali logarytmicznej.

valueinteger or null

(10 jednostek) Szacowana wartość miesięcznego ruchu organicznego na stronie, wyrażona w centach USD.