Przegląd SERP

API + MCP

GET/v3/rank-tracker/serp-overview

Żądania do tego punktu końcowego są bezpłatne i nie zużywają żadnych jednostek API.

Parametry zapytania

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.

devicestringWymagane

Wybierz rankingi mobilne lub desktopowe.

Dozwolone wartości:desktopmobile

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.

location_idinteger

Identyfikator lokalizacji śledzonego słowa kluczowego. Możesz użyć punktu końcowego management/project-keywords, aby uzyskać kody krajów, kody języków i identyfikatory lokalizacji dla śledzonych słów kluczowych w Twoim Projekcie.

countrystringWymagane

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

language_codestring

Kod języka śledzonego słowa kluczowego. Możesz użyć punktu końcowego management/project-keywords, aby uzyskać kody krajów, kody języków i identyfikatory lokalizacji dla śledzonych słów kluczowych w Twoim Projekcie.

keywordstringWymagane

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

project_idintegerWymagane

Unikalny identyfikator projektu. Możesz go znaleźć w adresie URL swojego projektu Rank Tracker w Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

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.

nr_wordsinteger or null

Całkowita liczba słów znajdujących się w kodzie HTML strony internetowej.

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

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

Szacunkowa średnia miesięczna liczba wyszukiwań dla najpopularniejszego słowa kluczowego w ciągu ostatnich 12 miesięcy.

trafficinteger or null

Oszacowanie miesięcznego organicznego ruchu z wyszukiwania, jaki wynik uzyskuje ze wszystkich słów kluczowych, na które się pozycjonuje.

typearray<string>

Rodzaj pozycji: organiczna, płatna lub jedna z Funkcji SERP. Dozwolone wartości: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

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

Szacowana wartość miesięcznego ruchu na stronie pochodzącego z organicznych wyników wyszukiwania, wyrażona w centach USD.