Органічні ключові слова

API + MCP

GET/v3/site-explorer/organic-keywords

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

timeoutinteger

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

limitinteger

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

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

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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

protocolstring

Протокол вашої цілі.

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

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

targetstring (url)Обов’язково

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

modestring

Обсяг пошуку залежно від цілі, яку ви ввели.

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

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

countrystring

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

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

date_comparedstring (date)

Дата для порівняння метрик у форматі YYYY-MM-DD.

datestring (date)Обов’язково

Дата, за яку потрібно надати метрики, у форматі YYYY-MM-DD.

volume_modestring

Режим обчислення обсягу пошуку: щомісячний або середній. Він впливає на обсяг, трафік і цінність трафіку.

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

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

outputstring

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

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

Відповіді

keywordsarray<object>

all_positionsarray<object>

(5 одиниць) Список усіх позицій для ключового слова.

all_positions_prevarray<object>

(5 одиниць) Список усіх позицій для ключового слова на дату порівняння.

best_positioninteger or null

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

best_position_diffinteger or null

Зміна позиції між вибраними датами.

best_position_has_thumbnailboolean or null

Найвища позиція має мініатюру.

best_position_has_thumbnail_prevboolean or null

Найвища позиція має мініатюру на дату порівняння.

best_position_has_videoboolean or null

Найвища позиція має відео.

best_position_has_video_prevboolean or null

Найвища позиція має відео на дату порівняння.

best_position_kindstring or null

Тип найвищої позиції: органічна, платна або функція SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

best_position_kind_mergedstring

Тип найвищої позиції, оптимізований для сортування.

best_position_kind_prevstring or null

Тип найвищої позиції на дату порівняння.

best_position_previnteger or null

Найвища позиція на дату порівняння.

best_position_setstring

Група ранжування найвищої позиції.

Allowed values:top_3top_4_10top_11_50top_51_more

best_position_set_prevstring or null

Група ранжування найвищої позиції на дату порівняння.

Allowed values:top_3top_4_10top_11_50top_51_more

best_position_urlstring (url) or null

URL-адреса, що ранжується в органічних результатах пошуку.

best_position_url_prevstring (url) or null

URL сторінки в рейтингу на дату порівняння.

cpcinteger or null

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

cpc_mergedinteger or null

Поле CPC, оптимізоване для сортування.

cpc_previnteger or null

Показник CPC на дату порівняння.

entitiesarray<object>

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

is_best_position_set_top_11_50boolean

Група ранжування найвищої позиції — 11–50.

is_best_position_set_top_11_50_prevboolean or null

На дату порівняння група ранжування найвищої позиції була 11–50.

is_best_position_set_top_3boolean

Група ранжування найвищої позиції — топ-3.

is_best_position_set_top_3_prevboolean or null

На дату порівняння група ранжування найвищої позиції була в топ-3.

is_best_position_set_top_4_10boolean

Група ранжування найвищої позиції — 4–10.

is_best_position_set_top_4_10_prevboolean or null

На дату порівняння група ранжування найвищої позиції була 4–10.

is_brandedboolean

Намір користувача: брендовий. Користувач шукає конкретний бренд або назву компанії.

is_commercialboolean

Намір користувача: комерційний. Користувач порівнює товари чи послуги перед прийняттям рішення про покупку.

is_informationalboolean

Намір користувача: інформаційний. Користувач шукає інформацію або відповідь на конкретне запитання.

is_localboolean

Намір користувача: локальний. Користувач шукає інформацію, пов'язану з конкретною місцевістю або послугами поблизу.

is_navigationalboolean

Намір користувача: навігаційний. Користувач шукає конкретний вебсайт або сторінку.

is_transactionalboolean

Намір користувача: транзакційний. Користувач готовий виконати дію, зазвичай покупку.

keywordstring or null

Ключове слово, за яким ранжується ваш цільовий ресурс.

keyword_countrystring

Країна ключового слова, за яким ранжується ваш цільовий ресурс.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

keyword_difficultyinteger or null

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

keyword_difficulty_mergedinteger or null

(10 одиниць) Поле «Складність ключового слова», оптимізоване для сортування.

keyword_difficulty_previnteger or null

(10 одиниць) Складність ключового слова на дату порівняння.

keyword_languagearray<string>

Мова пошукового запиту

keyword_mergedstring

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

keyword_prevstring or null

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

languagestring

Мова SERP.

language_prevstring or null

Мова SERP на дату порівняння.

last_updatestring (date-time)

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

last_update_prevstring (date-time) or null

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

serp_featuresarray<string>

Функції SERP, що з'являються в результатах пошуку за ключовим словом.

serp_features_countinteger

Кількість функцій SERP, що з'являються в результатах пошуку за ключовим словом.

serp_features_count_previnteger or null

Кількість функцій SERP станом на дату порівняння.

serp_features_mergedarray<string>

Поле «Функції SERP», оптимізоване для сортування.

serp_features_prevarray<string>

Функції SERP, що з'являються в результатах пошуку за ключовим словом станом на дату порівняння.

serp_target_main_positions_countinteger

Кількість цільових URL-адрес, що ранжуються за ключовим словом, без урахування позицій у Sitelinks, Top stories, Image packs і публікаціях на X (Twitter).

serp_target_main_positions_count_previnteger or null

Кількість цільових URL-адрес, що ранжуються за ключовим словом, без урахування позицій у Sitelinks, Top stories, Image packs і публікаціях на X (Twitter), станом на дату порівняння.

serp_target_positions_countinteger

Кількість цільових URL-адрес, що ранжуються за ключовим словом.

serp_target_positions_count_previnteger or null

Кількість цільових URL-адрес, що ранжуються за ключовим словом, станом на дату порівняння.

statusstring

Статус сторінки: нова сторінка, що щойно почала ранжуватися («left»), втрачена сторінка, що зникла з результатів пошуку («right»), або без змін («both»).

Allowed values:leftrightboth

sum_paid_trafficinteger or null

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

sum_paid_traffic_mergedinteger

(10 одиниць) Поле платного трафіку, оптимізоване для сортування.

sum_paid_traffic_previnteger or null

(10 одиниць) Платний трафік станом на дату порівняння.

sum_trafficinteger or null

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

sum_traffic_mergedinteger

(10 одиниць) Поле трафіку, оптимізоване для сортування.

sum_traffic_previnteger or null

(10 одиниць) Трафік на дату порівняння.

volumeinteger or null

(10 одиниць) Оцінка кількості пошукових запитів за ключовим словом за останній місяць.

volume_desktop_pctnumber (float) or null

Відсоток загального обсягу пошуку, що припадає на десктопні пристрої.

volume_mergedinteger or null

(10 одиниць) Поле обсягу пошуку, оптимізоване для сортування.

volume_mobile_pctnumber (float) or null

Відсоток загального обсягу пошуку, що припадає на мобільні пристрої.

volume_previnteger or null

(10 одиниць) Обсяг пошуку на дату порівняння.

wordsinteger or null

Кількість слів у ключовому слові.

words_mergedinteger

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

words_previnteger or null

Кількість слів у ключовому слові на дату порівняння.