Docs
Пошук документації...⌘K

Терміни, що збігаються

API + MCP
GET/v3/keywords-explorer/matching-terms

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

timeoutinteger

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

limitinteger

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

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

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

Example:field_a,field_b:asc,field_c:desc
wherestring

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

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

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

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

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

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

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

Дозволені значення:google
За Замовчуванням:google
keywordsstring

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

keyword_list_idinteger

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

match_modestring

Ідеї ключових слів містять слова з вашого запиту в будь-якому порядку (режим terms) або в тому самому порядку, у якому їх написано (режим phrase).

Дозволені значення:termsphrase
За Замовчуванням:terms
termsstring

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

Дозволені значення:allquestions
За Замовчуванням:all
outputstring

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

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

Відповіді

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

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