Огляд

API + MCP

GET/v3/keywords-explorer/overview

Фільтр regex має обмежену функціональність у цьому запиті, а синтаксис відрізняється від інших запитів. Як підстановочний символ він очікує зірочку (*).

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

timeoutinteger

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

limitinteger

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

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

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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

volume_monthly_date_tostring (date)

Кінцева дата у форматі YYYY-MM-DD для отримання історичних місячних значень обсягу пошуку в полі volume_monthly_history. Потрібно лише якщо запитано volume_monthly_history.

volume_monthly_date_fromstring (date)

Початкова дата у форматі YYYY-MM-DD для отримання історичних місячних значень обсягу пошуку в полі volume_monthly_history. Потрібно лише якщо запитано volume_monthly_history.

target_modestring

Охоплення (scope) вказаного вами цільового URL.

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

targetstring (url)

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

target_positionstring

Фільтрує ключові слова за позицією ранжування вказаного target.

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

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

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

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

keywordsstring

Список ключових слів, розділених комами, для яких потрібно показувати метрики.

keyword_list_idinteger

Ідентифікатор наявного списку ключових слів, для якого потрібно показувати метрики.

outputstring

The output format.

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

Відповіді

keywordsarray<object>

clicksinteger or null

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

cpcinteger or null

Ціна за клік показує середню ціну, яку рекламодавці платять за кожен клік по рекламі в платних результатах пошуку за ключовим словом, у центах США (USD).

cpsnumber (float) or null

Кількість кліків на пошук (або CPS) — це співвідношення Кліки до показника Обсяг пошуку за ключовим словом. Показує, скільки в середньому різних результатів пошуку отримують кліки, коли люди здійснюють пошук за цільовим ключовим словом у певній країні.

difficultyinteger or null

(10 одиниць) Оцінка того, наскільки складно потрапити в топ-10 органічної видачі за ключовим словом за 100-бальною шкалою.

first_seenstring (date-time) or null

Дата, коли ми вперше перевірили результати пошукової системи за ключовим словом.

global_volumeinteger or null

(10 одиниць) Скільки разів на місяць, у середньому, люди шукають цільове ключове слово в усіх країнах нашої бази даних.

intentsobject or null

(10 units) Вказує на намір пошукового запиту користувача. Поля об'єкта: informational, navigational, commercial, transactional, branded або local. Усі поля мають тип bool з можливими значеннями true або false.

keywordstring

parent_topicstring or null

Основна тема визначає, чи можете ви ранжуватися за цільовим ключовим словом, одночасно орієнтуючись на більш загальну тему на вашій сторінці. Щоб визначити основну тему, ми беремо сторінку №1 у рейтингу за вашим ключовим словом і знаходимо ключове слово, що відповідає за найбільший трафік на цій сторінці.

parent_volumeinteger or null

(10 units) Обсяг пошуку основної теми.

searches_pct_clicks_organic_and_paidnumber (float) or null

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

searches_pct_clicks_organic_onlynumber (float) or null

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

searches_pct_clicks_paid_onlynumber (float) or null

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

serp_featuresarray<string>

Розширені результати на сторінці результатів пошукової видачі (SERP), які не є традиційними органічними результатами.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring (date-time) or null

Дата, коли ми востаннє перевіряли результати з пошукової системи за ключовим словом.

traffic_potentialinteger or null

(10 units) Сума органічного трафіку, який сторінка №1 у рейтингу за вашим цільовим ключовим словом отримує з усіх ключових слів, за якими вона ранжується.

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

Відсоток пошукових запитів за ключовим словом, виконаних на стаціонарних пристроях.

volume_mobile_pctnumber (float) or null

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

volume_monthlyinteger or null

(10 units) Оцінка кількості пошукових запитів за ключовим словом за останній місяць. Це поле може не включатися в параметр order_by

volume_monthly_historyarray<object>

(2 units per historical month, with a minimum of 50 units) Історичні оцінки щомісячного обсягу пошуку для ключового слова за період, заданий параметрами volume_monthly_date_from і volume_monthly_date_to.