Платні сторінки

API + MCP

GET/v3/site-explorer/paid-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>

ads_countinteger or null

Кількість унікальних рекламних оголошень зі сторінкою.

ads_count_diffinteger

Зміна кількості оголошень між вашими вибраними датами.

ads_count_previnteger or null

Кількість оголошень на дату порівняння.

keywordsinteger or null

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

keywords_diffinteger

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

keywords_diff_percentinteger

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

keywords_mergedinteger

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

keywords_previnteger or null

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

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 одиниць) Орієнтовна вартість щомісячного платного пошукового трафіку сторінки в центах USD.

value_diffinteger

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

value_diff_percentinteger

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

value_mergedinteger or null

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

value_previnteger or null

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