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

cpc
typ: integer nullable

cpc_prev: Wartość CPC w dniu porównania.
typ: integer nullable

has_thumbnail: Pozycja ma miniaturę.
typ: boolean

has_thumbnail_prev: Pozycja miała miniaturę w dniu porównania.
typ: boolean

has_video: Pozycja ma wideo.
typ: boolean

has_video_prev: Pozycja miała wideo w dniu porównania.
typ: boolean

keyword: Słowo kluczowe, na które rankuje Twój cel.
typ: string

keyword_difficulty (10 jednostek): Trudność słowa kluczowego — szacunek tego, jak trudno jest znaleźć się w Top 10 organicznych wyników wyszukiwania dla słowa kluczowego, w skali 0–100.
typ: integer nullable

keyword_difficulty_prev (10 jednostek): Trudność słowa kluczowego w dniu porównania.
typ: integer nullable

keyword_prev: Słowo kluczowe, na które rankował Twój cel w dniu porównania.
typ: string

keywords: Łączna liczba słów kluczowych, na które Twój cel rankuje w Top 100 organicznych wyników wyszukiwania.
typ: integer

keywords_diff: Zmiana liczby słów kluczowych między wybranymi datami.
typ: integer

keywords_diff_percent: Zmiana liczby słów kluczowych między wybranymi datami (w procentach).
typ: integer

keywords_merged: Łączna liczba słów kluczowych zoptymalizowana pod sortowanie.
typ: integer

keywords_prev: Słowo kluczowe, na które rankował Twój cel w dniu porównania.
typ: integer

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

position: Pozycja, na jaką Twój cel rankuje w organicznych wynikach wyszukiwania dla słowa kluczowego.
typ: integer

position_kind: Typ pozycji: organiczna, płatna lub funkcja SERP. Dotyczy wszystkich pozycji dla danego słowa kluczowego i adresu URL przed wybraniem najwyższej pozycji.
typ: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_kind_prev: Typ pozycji w dniu porównania.
typ: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_prev: Pozycja Twojego celu dla danego słowa kluczowego w dniu porównania.
typ: integer

raw_url: Adres URL rankingującej strony w formacie zakodowanym.
typ: string

raw_url_prev: Adres URL rankingującej strony w dniu porównania w formacie zakodowanym.
typ: string

referring_domains (5 jednostek): Liczba unikalnych domen linkujących do strony.
typ: integer nullable

serp_features
typ: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_prev: Funkcje SERP w dniu porównania.
typ: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

status: Status strony: nowa strona, która właśnie zaczęła rankować ("left"), utracona strona, która zniknęła z wyników wyszukiwania ("right"), lub brak zmian ("both").
typ: string
enum: "left" "right" "both"

sum_traffic (10 jednostek): Szacunek miesięcznego ruchu organicznego strony ze wszystkich słów kluczowych, na które rankuje.
typ: integer nullable

sum_traffic_merged (10 jednostek): Pole ruchu zoptymalizowane pod sortowanie.
typ: integer

sum_traffic_prev (10 jednostek): Ruch w dniu porównania.
typ: integer nullable

top_keyword: Najlepsze słowo kluczowe — słowo kluczowe, które przynosi stronie najwięcej ruchu organicznego.
typ: string nullable

top_keyword_best_position: Pozycja, jaką strona zajmuje dla swojego najlepszego słowa kluczowego.
typ: integer nullable

top_keyword_best_position_diff: Zmiana najwyższej pozycji między wybranymi datami.
typ: integer nullable

top_keyword_best_position_kind: Typ najwyższej pozycji: organiczna, płatna lub funkcja SERP.
typ: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_kind_prev: Typ najwyższej pozycji w dniu porównania.
typ: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_prev: Najwyższa pozycja w dniu porównania.
typ: integer nullable

top_keyword_best_position_title: Tytuł wyświetlany dla strony w SERP jej najlepszego słowa kluczowego.
typ: string nullable

top_keyword_best_position_title_prev: Tytuł wyświetlany dla strony w SERP jej najlepszego słowa kluczowego w dniu porównania.
typ: string nullable

top_keyword_country: Kraj, w którym strona rankuje dla swojego najlepszego słowa kluczowego.
typ: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_country_prev: Kraj, w którym strona rankowała dla swojego najlepszego słowa kluczowego w dniu porównania.
typ: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_prev: Najlepsze słowo kluczowe, które przynosiło stronie najwięcej ruchu organicznego w dniu porównania.
typ: string nullable

top_keyword_volume (10 jednostek): Wolumen wyszukiwań dla najlepszego słowa kluczowego — szacunek średniej miesięcznej liczby wyszukiwań w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych (w zależności od parametru "volume_mode").
typ: integer nullable

top_keyword_volume_prev (10 jednostek): Wolumen wyszukiwań w dniu porównania.
typ: integer nullable

traffic (10 jednostek): Szacunek liczby miesięcznych odwiedzających, jakich Twój cel uzyskuje z wyszukiwania organicznego dla słowa kluczowego.
typ: integer

traffic_diff: Zmiana ruchu między wybranymi datami.
typ: integer

traffic_diff_percent: Zmiana ruchu między wybranymi datami (w procentach).
typ: integer

traffic_prev (10 jednostek): Ruch ze słowa kluczowego w dniu porównania.
typ: integer

ur: URL Rating (UR) pokazuje siłę profilu linków zwrotnych Twojej strony docelowej w skali logarytmicznej 0–100.
typ: float nullable

url: Rankingujący adres URL strony.
typ: url nullable

url_prev: Rankingujący adres URL strony w dniu porównania.
typ: url nullable

value (10 jednostek): Wartość ruchu — szacowana wartość miesięcznego ruchu organicznego strony (w centach USD).
typ: integer nullable

value_diff: Zmiana wartości ruchu między wybranymi datami.
typ: integer

value_diff_percent: Zmiana wartości ruchu między wybranymi datami (w procentach).
typ: integer

value_merged (10 jednostek): Pole wartości ruchu zoptymalizowane pod sortowanie.
typ: integer nullable

value_prev (10 jednostek): Wartość ruchu w dniu porównania.
typ: integer nullable

volume (10 jednostek): Wolumen wyszukiwań — szacunek liczby wyszukiwań słowa kluczowego w ostatnim miesiącu.
typ: integer nullable

volume_prev (10 jednostek): Wolumen wyszukiwań w dniu porównania.
typ: integer nullable

words: Liczba słów w słowie kluczowym.
typ: integer

words_prev: Liczba słów w słowie kluczowym w dniu porównania.
typ: integer

selectstringWymagane

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

protocolstring

Protokół Twojego celu.

Dozwolone wartości:bothhttphttps

Domyślne:both

targetstringWymagane

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

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

datestringWymagane

Data, dla której mają zostać zaraportowane 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 or null

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

urlstring or null

Adres URL strony rankującej.

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