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

API + MCP

GET/v3/site-explorer/top-pages

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

timeoutinteger

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

limitinteger

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

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

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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

protocolstring

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

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

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

targetstring (url)Обов’язково

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

modestring

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

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

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

countrystring

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

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

date_comparedstring (date)

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

datestring (date)Обов’язково

Дата, станом на яку потрібні метрики, у форматі 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 (float) or null

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

urlstring (url) or null

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

url_prevstring (url) or null

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

valueinteger or null

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

value_diffinteger

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

value_diff_percentinteger

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

value_mergedinteger or null

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

value_previnteger or null

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