Przegląd SERP

API + MCP

GET/v3/serp-overview/serp-overview

Parametry zapytania

selectstringWymagane

Lista kolumn zwracanych w odpowiedzi, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

top_positionsinteger

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

datestring

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.

countrystringWymagane

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordstringWymagane

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

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

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 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.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

update_datestring

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

urlstring or null

Adres URL strony w rankingu.

url_ratingnumber 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.