Огляд

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).

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

cpc: Ціна за клік показує середню ціну, яку рекламодавці сплачують за кожен клік по оголошенню в платних результатах пошуку за ключовим словом, у центах USD.
type: integer nullable

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

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

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

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

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

keyword:
type: string

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

parent_volume (10 units): Обсяг пошуку для основної теми.
type: integer nullable

serp_domain_rating_top10_min: Ключове слово повинно мати щонайменше одну позицію в топ-10 результатів із DR до цього значення.
type: float nullable

serp_domain_rating_top5_min: Ключове слово повинно мати щонайменше одну позицію в топ-5 результатів із DR до цього значення.
type: float nullable

serp_features: Розширені результати на сторінці результатів пошуку (SERP), які не є традиційними органічними результатами.
type: array(string)
enum: \"ai_overview_sitelink\" \"snippet\" \"ai_overview\" \"local_pack\" \"sitelink\" \"news\" \"image\" \"video\" \"discussion\" \"tweet\" \"paid_top\" \"paid_bottom\" \"paid_sitelink\" \"shopping\" \"knowledge_card\" \"knowledge_panel\" \"question\" \"image_th\" \"video_th\" \"organic_shopping\"

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

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

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

volume_desktop_pct: Відсоток пошуків за ключовим словом, виконаних на десктопних пристроях.
type: float nullable

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

word_count:
type: integer

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

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

volume_monthly_date_tostring

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

volume_monthly_date_fromstring

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

target_modestring

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

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

targetstring

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

target_positionstring

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

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

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

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

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

search_enginestring

[Застаріло з 5 серпня 2024].

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

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

keywordsstring

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

keyword_list_idinteger

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

outputstring

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

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

Відповіді

keywordsarray<object>

clicksinteger or null

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

cpcinteger or null

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

cpsnumber or null

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

difficultyinteger or null

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

first_seenstring 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 or null

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

searches_pct_clicks_organic_onlynumber or null

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

searches_pct_clicks_paid_onlynumber or null

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

serp_featuresarray<string>

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

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring or null

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

traffic_potentialinteger or null

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

volumeinteger or null

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

volume_desktop_pctnumber or null

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

volume_mobile_pctnumber 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.