Огляд

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) для коректних ідентифікаторів стовпців.

keyword_list_idinteger

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

keywordsstring

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

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

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

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

target_positionstring

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

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

targetstring (url)

Об’єкт пошуку: домен або URL-адреса.

modestring

Область дії цілі.

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

volume_monthly_date_fromstring (date)

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

volume_monthly_date_tostring (date)

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

outputstring

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

Дозволені значення: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), які не є традиційними органічними результатами.

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

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.