Топ-сторінки

API + MCP

GET/v3/site-explorer/top-pages

Параметри запиту

timeoutinteger

Тривалість таймауту в секундах, задана вручну.

limitinteger

Кількість результатів, які потрібно повернути.

За Замовчуванням:1000

order_bystring

Список стовпців, розділених комами, за якими слід упорядкувати результати, з необов'язковим напрямком. Див. схему відповіді для дійсних ідентифікаторів стовпців.

Example:field_a,field_b:asc,field_c:desc

wherestring

Вираз фільтра. Розпізнаються такі ідентифікатори стовпців (вони відрізняються від ідентифікаторів, які розпізнає параметр select).

cpc
type: integer nullable

cpc_prev: Значення CPC на дату порівняння.
type: integer nullable

has_thumbnail: Для позиції є мініатюра.
type: boolean

has_thumbnail_prev: Для позиції була мініатюра на дату порівняння.
type: boolean

has_video: Для позиції є відео.
type: boolean

has_video_prev: Для позиції було відео на дату порівняння.
type: boolean

keyword: Ключове слово, за яким ранжується ваша ціль.
type: string

keyword_difficulty (10 units): Оцінка того, наскільки складно потрапити в топ-10 органічної видачі для ключового слова за 100-бальною шкалою.
type: integer nullable

keyword_difficulty_prev (10 units): Складність ключового слова на дату порівняння.
type: integer nullable

keyword_prev: Ключове слово, за яким ранжувалася ваша ціль на дату порівняння.
type: string

keywords: Загальна кількість ключових слів, за якими ваша ціль ранжується в топ-100 органічної видачі.
type: integer

keywords_diff: Зміна кількості ключових слів між вибраними датами.
type: integer

keywords_diff_percent: Зміна кількості ключових слів між вибраними датами, у відсотках.
type: integer

keywords_merged: Загальна кількість ключових слів, оптимізована для сортування.
type: integer

keywords_prev: Кількість ключових слів на дату порівняння.
type: integer

page_type: Список ієрархічних шляхів типів сторінок, прогнозованих ШІ (через кому). Кожне значення — шлях із префіксом / (наприклад, /Article/How_to).
type: string nullable

position: Позиція, яку ваша ціль займає в органічній видачі для ключового слова.
type: integer

position_kind: Тип позиції: органічна, платна або функція SERP. Це застосовується до всіх позицій для конкретного ключового слова та URL перед вибором найвищої позиції.
type: 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: Тип позиції на дату порівняння.
type: 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: Позиція вашої цілі для ключового слова на дату порівняння.
type: integer

raw_url: URL сторінки, що ранжується, у закодованому форматі.
type: string

raw_url_prev: URL сторінки, що ранжувалася на дату порівняння, у закодованому форматі.
type: string

referring_domains (5 units): Кількість унікальних доменів, що посилаються на сторінку.
type: integer nullable

serp_features
type: 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: Функції SERP на дату порівняння.
type: 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: Статус сторінки: нова сторінка, яка щойно почала ранжуватися ("left"), втрачена сторінка, яка зникла з результатів пошуку ("right"), або без змін ("both").
type: string
enum: "left" "right" "both"

sum_traffic (10 units): Оцінка щомісячного органічного пошукового трафіку сторінки за всіма ключовими словами, за якими вона ранжується.
type: integer nullable

sum_traffic_merged (10 units): Поле трафіку, оптимізоване для сортування.
type: integer

sum_traffic_prev (10 units): Трафік на дату порівняння.
type: integer nullable

top_keyword: Основне ключове слово, яке приносить сторінці найбільше органічного трафіку.
type: string nullable

top_keyword_best_position: Позиція, яку сторінка займає за своїм основним ключовим словом.
type: integer nullable

top_keyword_best_position_diff: Зміна найвищої позиції між вибраними датами.
type: integer nullable

top_keyword_best_position_kind: Тип найвищої позиції: органічна, платна або функція SERP.
type: 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: Тип найвищої позиції на дату порівняння.
type: 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: Найвища позиція на дату порівняння.
type: integer nullable

top_keyword_best_position_title: Заголовок, який відображається для сторінки в SERP за її основним ключовим словом.
type: string nullable

top_keyword_best_position_title_prev: Заголовок, який відображався для сторінки в SERP за її основним ключовим словом на дату порівняння.
type: string nullable

top_keyword_country: Країна, у якій сторінка ранжується за своїм основним ключовим словом.
type: 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: Країна, у якій сторінка ранжувалася за своїм основним ключовим словом на дату порівняння.
type: 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: Основне ключове слово, яке приносило сторінці найбільше органічного трафіку на дату порівняння.
type: string nullable

top_keyword_volume (10 units): Оцінка середньомісячного обсягу пошуку для основного ключового слова за останній місяць або за останні відомі 12 місяців даних залежно від параметра "volume_mode".
type: integer nullable

top_keyword_volume_prev (10 units): Обсяг пошуку на дату порівняння.
type: integer nullable

traffic (10 units): Оцінка кількості щомісячних відвідувачів, яких ваша ціль отримує з органічного пошуку за ключовим словом.
type: integer

traffic_diff: Зміна трафіку між вибраними датами.
type: integer

traffic_diff_percent: Зміна трафіку між вибраними датами, у відсотках.
type: integer

traffic_prev (10 units): Трафік із ключового слова на дату порівняння.
type: integer

ur: URL Rating (UR) показує силу профілю беклінків вашої цільової сторінки за 100-бальною логарифмічною шкалою.
type: float nullable

url: URL сторінки, що ранжується.
type: url nullable

url_prev: URL сторінки, що ранжувалася на дату порівняння.
type: url nullable

value (10 units): Цінність трафіку сторінки за місяць, у центах USD.
type: integer nullable

value_diff: Зміна цінності трафіку між вибраними датами.
type: integer

value_diff_percent: Зміна цінності трафіку між вибраними датами, у відсотках.
type: integer

value_merged (10 units): Поле цінності трафіку, оптимізоване для сортування.
type: integer nullable

value_prev (10 units): Цінність трафіку на дату порівняння.
type: integer nullable

volume (10 units): Оцінка кількості пошуків за ключовим словом за останній місяць.
type: integer nullable

volume_prev (10 units): Обсяг пошуку на дату порівняння.
type: integer nullable

words: Кількість слів у ключовому слові.
type: integer

words_prev: Кількість слів у ключовому слові на дату порівняння.
type: integer

selectstringОбов’язково

Список стовпців, розділених комами, які потрібно повернути. Див. Schema відповіді для коректних ідентифікаторів стовпців.

protocolstring

Протокол вашої цілі.

Дозволені значення:bothhttphttps

За Замовчуванням:both

targetstringОбов’язково

Ціль пошуку: домен або URL.

modestring

Обсяг пошуку залежно від цілі, яку ви ввели.

Дозволені значення:exactprefixdomainsubdomains

За Замовчуванням:subdomains

countrystring

Дволітерний код країни (ISO 3166-1 alpha-2).

Дозволені значення:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring

Дата для порівняння метрик у форматі YYYY-MM-DD.

datestringОбов’язково

Дата, станом на яку потрібні метрики, у форматі YYYY-MM-DD.

volume_modestring

Режим обчислення обсягу пошуку: щомісячний або середній. Він впливає на обсяг, трафік і цінність трафіку.

Дозволені значення:monthlyaverage

За Замовчуванням:monthly

outputstring

Формат виводу.

Дозволені значення:jsoncsvxmlphp

Відповіді

pagesarray<object>

keywordsinteger or null

Загальна кількість ключових слів, за якими ваша ціль займає перші 100 позицій в результатах органічного пошуку.

keywords_diffinteger

Зміна ключових слів між обраними вами датами.

keywords_diff_percentinteger

Зміна ключових слів між обраними вами датами, у відсотках.

keywords_mergedinteger

Загальна кількість ключових слів, оптимізована для сортування.

keywords_previnteger or null

Ключове слово, за яким ранжується ваш цільовий ресурс, на дату порівняння.

page_typestring or null

Розділений комами список ієрархічних шляхів типів сторінок, спрогнозованих ШІ. Кожне значення — це шлях із префіксом «/» (наприклад, /Article/How_to).

raw_urlstring

URL сторінки в рейтингу в закодованому форматі.

raw_url_prevstring or null

URL сторінки в рейтингу на дату порівняння в закодованому форматі.

referring_domainsinteger or null

(5 одиниць) Кількість унікальних доменів, що посилаються на сторінку.

statusstring

Статус сторінки: нова сторінка, що щойно почала ранжуватися («left»), втрачена сторінка, що зникла з результатів пошуку («right»), або без змін («both»).

Allowed values:leftrightboth

sum_trafficinteger or null

(10 одиниць) Оцінка щомісячного органічного пошукового трафіку, який отримує сторінка за всіма ключовими словами, за якими вона ранжується.

sum_traffic_mergedinteger

(10 одиниць) Поле трафіку, оптимізоване для сортування.

sum_traffic_previnteger or null

(10 одиниць) Трафік на дату порівняння.

top_keywordstring or null

Ключове слово, яке приносить сторінці найбільше органічного трафіку.

top_keyword_best_positioninteger or null

Позиція в рейтингу, яку займає сторінка для свого основного ключового слова.

top_keyword_best_position_diffinteger or null

Зміна найвищої позиції між вибраними датами.

top_keyword_best_position_kindstring or null

Тип найвищої позиції: органічна, платна або Функції SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

top_keyword_best_position_kind_prevstring or null

Тип найвищої позиції на дату порівняння.

top_keyword_best_position_previnteger or null

Найвища позиція на дату порівняння.

top_keyword_best_position_titlestring or null

Заголовок, що відображається для сторінки в SERP її основного ключового слова.

top_keyword_best_position_title_prevstring or null

Заголовок, що відображається для сторінки в SERP її основного ключового слова на дату порівняння.

top_keyword_countrystring or null

Країна, у якій сторінка ранжується за своїм основним ключовим словом.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

top_keyword_country_prevstring or null

Країна, у якій сторінка ранжується за своїм основним ключовим словом на дату порівняння.

top_keyword_prevstring or null

Ключове слово, яке приносить найбільше органічного трафіку на сторінку на дату порівняння.

top_keyword_volumeinteger or null

(10 одиниць) Оцінка середньої щомісячної кількості запитів за основним ключовим словом за останній місяць або за останні відомі 12 місяців даних залежно від параметра "volume_mode".

top_keyword_volume_previnteger or null

(10 одиниць) Обсяг пошуку на дату порівняння.

traffic_diffinteger

Зміна в трафіку між вашими вибраними датами.

traffic_diff_percentinteger

Зміна в трафіку між вашими вибраними датами, у відсотках.

urnumber or null

Рейтинг URL-сторінки (UR) показує силу профілю беклінків вашої цільової сторінки за 100-бальною логарифмічною шкалою.

urlstring or null

URL сторінки, що ранжується.

url_prevstring or null

URL сторінки, що ранжується, на дату порівняння.

valueinteger or null

(10 units) Приблизна вартість щомісячного органічного пошукового трафіку сторінки в центах USD.

value_diffinteger

Зміна значення трафіку між вибраними датами.

value_diff_percentinteger

Зміна цінності трафіку між вибраними датами, у відсотках.

value_mergedinteger or null

(10 одиниць) Поле «Цінність трафіку», оптимізоване для сортування.

value_previnteger or null

(10 одиниць) Цінність трафіку на дату порівняння.