Пошукові підказки

API + MCP

GET/v3/keywords-explorer/search-suggestions

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

timeoutinteger

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

limitinteger

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

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

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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

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

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

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

keywordsstring

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

keyword_list_idinteger

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

outputstring

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

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

Відповіді

keywordsarray<object>

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 у рейтингу за вашим ключовим словом і знаходимо ключове слово, що відповідає за найбільший трафік на цій сторінці.

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