Najlepsze strony

API + MCP

GET/v3/site-explorer/top-pages

Parametry zapytania

timeoutinteger

Ręcznie ustawiany limit czasu w sekundach.

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

order_bystring

Rozdzielana przecinkami lista kolumn, według których mają być sortowane wyniki, z opcjonalnym kierunkiem sortowania. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

Example:field_a,field_b:asc,field_c:desc

wherestring

Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się od identyfikatorów rozpoznawanych przez parametr select).

selectstringWymagane

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

protocolstring

Protokół Twojego celu.

Dozwolone wartości:bothhttphttps

Domyślne:both

targetstring (url)Wymagane

Cel wyszukiwania: domena lub adres URL.

modestring

Zakres wyszukiwania na podstawie podanego celu.

Dozwolone wartości:exactprefixdomainsubdomains

Domyślne:subdomains

countrystring

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring (date)

Data do porównania metryk w formacie YYYY-MM-DD.

datestring (date)Wymagane

Data, dla której mają zostać zwrócone metryki, w formacie YYYY-MM-DD.

volume_modestring

Tryb obliczania Wolumen wyszukiwań: miesięczny lub średni. Wpływa na wolumen, ruch i Wartość ruchu.

Dozwolone wartości:monthlyaverage

Domyślne:monthly

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

pagesarray<object>

keywordsinteger or null

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

keywords_diffinteger

Zmiana dotycząca słów kluczowych pomiędzy wybranymi datami.

keywords_diff_percentinteger

Zmiana dotycząca słów kluczowych pomiędzy wybranymi datami, w procentach.

keywords_mergedinteger

Całkowita liczba słów kluczowych zoptymalizowanych pod kątem sortowania.

keywords_previnteger or null

Słowo kluczowe, na które pozycjonuje się Twój cel na datę porównawczą.

page_typestring or null

Lista rozdzielonych przecinkami ścieżek hierarchicznych typów stron przewidzianych przez AI. Każda wartość to ścieżka poprzedzona ukośnikiem (np. /Article/How_to).

raw_urlstring

Adres URL strony w rankingu w zakodowanym formacie.

raw_url_prevstring or null

Adres URL strony w rankingu na datę porównawczą w zakodowanym formacie.

referring_domainsinteger or null

(5 jednostek) Liczba unikalnych domen odsyłających do strony.

statusstring

Status strony: nowa strona, która właśnie zaczęła się pozycjonować („left”), utracona strona, która zniknęła z wyników wyszukiwania („right”), albo brak zmian („both”).

Allowed values:leftrightboth

sum_trafficinteger or null

(10 jednostek) Szacunkowy miesięczny ruch z wyszukiwania organicznego, jaki strona uzyskuje ze wszystkich słów kluczowych, na które się pozycjonuje.

sum_traffic_mergedinteger

(10 jednostek) Pole ruchu zoptymalizowane pod kątem sortowania.

sum_traffic_previnteger or null

(10 jednostek) Ruch na datę porównania.

top_keywordstring or null

Słowo kluczowe generujące największy ruch organiczny na stronie.

top_keyword_best_positioninteger or null

Pozycja strony w rankingu dla jej najpopularniejszego słowa kluczowego.

top_keyword_best_position_diffinteger or null

Zmiana najlepszej pozycji między wybranymi datami.

top_keyword_best_position_kindstring or null

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

top_keyword_best_position_kind_prevstring or null

Rodzaj najwyższej pozycji w dniu porównania.

top_keyword_best_position_previnteger or null

Najwyższa pozycja w dniu porównania.

top_keyword_best_position_titlestring or null

Tytuł wyświetlany dla strony w SERP dla jej najlepszego słowa kluczowego.

top_keyword_best_position_title_prevstring or null

Tytuł wyświetlany dla strony w SERP dla jej najlepszego słowa kluczowego na datę porównawczą.

top_keyword_countrystring or null

Kraj, w którym strona jest notowana dla jej najlepszego słowa kluczowego.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

top_keyword_country_prevstring or null

Kraj, w którym strona jest notowana dla jej najlepszego słowa kluczowego na datę porównawczą.

top_keyword_prevstring or null

Słowo kluczowe, które na datę porównawczą generuje dla strony największy ruch organiczny.

top_keyword_volumeinteger or null

(10 jednostek) Szacunkowa średnia miesięczna liczba wyszukiwań dla najlepszego słowa kluczowego z ostatniego miesiąca lub z ostatnich znanych 12 miesięcy danych (w zależności od parametru „volume_mode").

top_keyword_volume_previnteger or null

(10 jednostek) Wolumen wyszukiwań na datę porównania.

traffic_diffinteger

Zmiana ruchu pomiędzy wybranymi datami.

traffic_diff_percentinteger

Zmiana ruchu pomiędzy wybranymi datami, w procentach.

urnumber (float) or null

Ocena URL (UR) pokazuje siłę profilu linków zwrotnych Twojej strony docelowej w 100-punktowej skali logarytmicznej.

urlstring (url) or null

Adres URL strony rankującej.

url_prevstring (url) or null

Adres URL strony rankującej w dniu porównania.

valueinteger or null

(10 units) Szacunkowa wartość miesięcznego ruchu organicznego na stronie, w centach USD.

value_diffinteger

Różnica w wartości ruchu pomiędzy wybranymi datami.

value_diff_percentinteger

Różnica w metryce „Wartość ruchu” pomiędzy wybranymi datami, w procentach.

value_mergedinteger or null

(10 jednostek) Pole „Wartość ruchu” zoptymalizowane pod kątem sortowania.

value_previnteger or null

(10 jednostek) „Wartość ruchu” w dniu porównania.