v0.2.0-beta

OpenAPI 3.1.0

Підказки ключових слів

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

post/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live

Підказки ключових слів

Довгохвостові варіанти, що містять одне keyword, — подання за точним збігом фрази, тоді як post_dataforseo_labs_google_keyword_ideas_live — семантичне. Повертає seed_keyword, seed_keyword_data, total_count, offset_token і items. Сторінки з limit, offset і offset_token; використовуйте токен після перших сторінок. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200.

Довідкові ціни

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.132.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

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

Тіло

application/json

Тип: array (object | null)[]
- exact_match
  Тип: boolean | null
  
  пошук точної фрази
  необов'язкове поле
  якщо задано true, повернуті ключові слова міститимуть указану точну фразу, а перед нею або після неї можуть бути інші слова
  значення за замовчуванням: false
- filters
  Тип: array (object | null)[] | null
  
  масив параметрів фільтрації результатів
  необов'язкове поле
  можна додати кілька фільтрів одночасно (не більше 8)
  між умовами потрібно вказати логічний оператор and або or
  підтримуються такі оператори:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  оператор % можна використовувати з like і not_like, а також з ilike і not_ilike для зіставлення будь-якого рядка з нуля або більше символів
  приклад:
  ["keyword_info.search_volume",">",0]
  [["keyword_info.search_volume","in",[0,1000]], "and", ["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100], "and", [["keyword_info.cpc","<",0.5], "or", ["keyword_info.high_top_of_page_bid","<=",0.5]]]
  Докладніше про фільтри — у Dataforseo Labs - Filters або в цьому посібнику довідкового центру
  
  Порожній об'єкт
- ignore_synonyms
  Тип: boolean | null
  
  ігнорувати дуже схожі ключові слова
  необов'язкове поле
  якщо задано true, буде повернуто лише основні ключові слова, а всі дуже схожі ключові слова виключено;
  значення за замовчуванням: false
- include_clickstream_data
  Тип: boolean | null
  
  включення або виключення даних клікстрім-метрик у результаті
  необов'язкове поле
  якщо параметр установлено в true, ви отримаєте у відповіді поля clickstream_keyword_info, keyword_info_normalized_with_clickstream і keyword_info_normalized_with_bing
  значення за замовчуванням: false
  під час увімкнення цього параметра вартість запиту буде подвоєна
  
  докладніше про те, як розраховуються метрики на основі клікстріму, — у цій статті довідкового центру
- include_seed_keyword
  Тип: boolean | null
  
  включити дані для початкового ключового слова
  необов'язкове поле
  якщо встановлено true, дані для початкового ключового слова, указаного в полі keyword, буде надано в масиві seed_keyword_data відповіді
  значення за замовчуванням: false
- include_serp_info
  Тип: boolean | null
  
  включити дані SERP для кожного ключового слова
  необов'язкове поле
  якщо встановлено true, ми повернемо масив serp_info, що містить дані SERP (кількість результатів пошуку, релевантний URL і функції SERP) для кожного ключового слова у відповіді
  значення за замовчуванням: false
- keyword
  Тип: string
  
  ключове слово
  обов'язкове поле
  кодування UTF-8
  ключові слова переводяться в нижній регістр;
  
  Докладніше про правила й обмеження полів keyword і keywords в API DataForSEO — у цій статті довідкового центру
- language_code
  Тип: string | null
  
  код мови
  необов'язкове поле
  якщо використовуєте це поле, language_name вказувати не потрібно
  список доступних мов з їхніми language_code можна отримати окремим запитом
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  приклад:
  en
  Примітка: якщо поле не вказано, за замовчуванням використовується мова з найбільшою кількістю записів ключових слів у вказаному місцезнаходженні;
  щоб визначити мову за замовчуванням, зверніться до поля available_languages.keywords ендпоінта Locations and Languages
- language_name
  Тип: string | null
  
  повна назва мови
  необов'язкове поле
  якщо використовуєте це поле, language_code вказувати не потрібно
  список доступних мов з їхніми language_name можна отримати окремим запитом
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  приклад:
  English
  Примітка: якщо поле не вказано, за замовчуванням використовується мова з найбільшою кількістю записів ключових слів у вказаному місцезнаходженні;
  щоб визначити мову за замовчуванням, зверніться до поля available_languages.keywords ендпоінта Locations and Languages
- limit
  Тип: integer | null
  
  максимальна кількість ключових слів, що повертаються
  необов'язкове поле
  значення за замовчуванням: 100
  максимальне значення: 1000
- location_code
  Тип: integer | null
  
  код місцезнаходження
  необов'язкове поле
  якщо використовуєте це поле, location_name вказувати не потрібно
  список доступних місцезнаходжень із location_code можна отримати окремим запитом
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  не вказуйте це поле, щоб отримати результати для всіх доступних місцезнаходжень
  приклад:
  2840
- location_name
  Тип: string | null
  
  повна назва місцезнаходження
  необов'язкове поле
  якщо використовуєте це поле, location_code вказувати не потрібно
  список доступних місцезнаходжень із location_name можна отримати окремим запитом
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  не вказуйте це поле, щоб отримати результати для всіх доступних місцезнаходжень
  приклад:
  United Kingdom
- offset
  Тип: integer | null
  
  зміщення в масиві результатів повернутих ключових слів
  необов'язкове поле
  значення за замовчуванням: 0
  якщо вказати значення 10, перші десять ключових слів у масиві результатів буде пропущено, а дані буде надано для наступних ключових слів
  Примітка: цей параметр рекомендується використовувати лише під час отримання до 10 000 результатів
  для отримання понад 10 000 результатів використовуйте натомість offset_token.
- offset_token
  Тип: string | null
  
  токен зміщення для наступних запитів
  необов'язкове поле
  надається в тому самому полі відповіді на кожен запит;
  використовуйте цей параметр, щоб уникнути тайм-аутів під час спроби отримати понад 10 000 результатів в одному запиті;
  вказавши унікальне значення offset_token з масиву відповіді, ви отримаєте наступні результати початкового завдання;
  значення offset_token унікальні для кожного наступного завдання
  Примітка: якщо в запиті вказано offset_token, під час обробки завдання всі інші параметри, крім limit, не враховуються.
  Докладніше про цей параметр — у довідковому центрі
- order_by
  Тип: array string[] | null
  
  правила сортування результатів
  необов'язкове поле
  для сортування результатів можна використовувати ті самі значення, що й у масиві filters
  можливі типи сортування:
  asc - результати сортуються за зростанням
  desc - результати сортуються за спаданням
  кома використовується як роздільник
  приклад:
  ["keyword_info.competition,desc"]
  правило за замовчуванням:
  ["keyword_info.search_volume,desc"]
  в одному запиті можна задати не більше трьох правил сортування
  кілька правил сортування потрібно розділяти комою
  приклад:
  ["keyword_info.search_volume,desc","keyword_info.cpc,desc"]
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді

Відповіді

200
Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

data
Тип: object | null

містить ті самі параметри, які ви вказали в POST-запиті

propertyName
Тип: object | null
id
Тип: string | null

ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

path
Тип: array (string | null)[] | null

шлях URL

result
Тип: array (object | null)[] | null

масив результатів

items
Тип: array (object | null)[] | null

містить ключові слова та пов'язані дані

avg_backlinks_info
Тип: object | null · Response36Afe1097B20_AvgBacklinksInfo

дані про зворотні посилання для повернутого ключового слова
цей об'єкт містить середню кількість зворотних посилань, сторінок і доменів, що посилаються, а також середні значення рейтингу серед 10 веб-сторінок, що органічно ранжуються за ключовим словом

backlinks
Тип: number | null

середня кількість зворотних посилань

dofollow
Тип: number | null

середня кількість dofollow-посилань

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

main_domain_rank
Тип: number | null

середній рейтинг основного домену
докладніше про метрику та формулу її розрахунку — у цій статті довідкового центру

rank
Тип: number | null

середній ранг
Докладніше про метрику та формулу її розрахунку — у цій статті довідкового центру

referring_domains
Тип: number | null

середня кількість доменів, що посилаються

referring_main_domains
Тип: number | null

середня кількість основних доменів, що посилаються

referring_pages
Тип: number | null

середня кількість сторінок, що посилаються

se_type
Тип: string | null

тип пошукової системи

clickstream_keyword_info
Тип: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

дані clickstream для повернутого ключового слова
щоб отримати результати для цього поля, параметр include_clickstream_data має бути встановлено в true

age_distribution
Тип: object | null

розподіл метрик на основі клікстріму за віком
Докладніше про те, як розраховується ця метрика, — у цій статті довідкового центру

propertyName
Тип: integer | null Формат: int64

Signed 64-bit integers (long type).

gender_distribution
Тип: object | null

розподіл оцінюваних метрик на основі клікстріму за статтю
Докладніше про те, як розраховується ця метрика, — у цій статті довідкового центру

propertyName
Тип: integer | null Формат: int64

Signed 64-bit integers (long type).

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

monthly_searches
Тип: array (object | null)[] | null

щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

search_volume
Тип: integer | null Формат: int64

середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com

keyword
Тип: string | null

повернута ідея ключового слова

keyword_info
Тип: object | null · Response36Afe1097B20_KeywordInfo

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

categories
Тип: array integer[] | null

категорії товарів і послуг
ви можете завантажити повний перелік можливих категорій

competition
Тип: number | null

конкуренція
відносний рівень конкуренції за зазначеним ключовим словом. Значення базується на даних Google Ads і може перебувати в діапазоні від 0 до 1 включно

competition_level
Тип: string | null

рівень конкуренції
відносний рівень конкуренції за зазначеним ключовим словом лише в платній видачі SERP;
можливі значення: LOW, MEDIUM, HIGH
якщо рівень конкуренції невідомий, значення — null;
докладніше про метрику — у цій статті довідкового центру

cpc
Тип: number | null

ціна за клік
середня ціна за клік (USD), історично сплачена за ключове слово

high_top_of_page_bid
Тип: number | null

максимальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 80% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

low_top_of_page_bid
Тип: number | null

мінімальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 20% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті

monthly_searches
Тип: array (object | null)[] | null

щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

se_type
Тип: string | null

тип пошукової системи

search_volume
Тип: integer | null Формат: int64

середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com

search_volume_trend
Тип: object | null · Response36Afe1097B20_SearchVolumeTrend

зміни тренду пошукового обсягу
зміна пошукового обсягу у відсотках порівняно з попереднім періодом

monthly
Тип: integer | null

зміна обсягу пошуку у відсотках порівняно з попереднім місяцем

quarterly
Тип: integer | null

зміна обсягу пошуку у відсотках порівняно з попереднім кварталом

yearly
Тип: integer | null

зміна обсягу пошуку у відсотках порівняно з попереднім роком

keyword_info_normalized_with_bing
Тип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

містить обсяг пошуку за ключовим словом, нормалізований за обсягом пошуку Bing

is_normalized
Тип: boolean | null

дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing

last_updated_time
Тип: string | null

дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00

monthly_searches
Тип: array (object | null)[] | null

помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

search_volume
Тип: integer | null

поточний показник пошукового обсягу ключового слова

keyword_info_normalized_with_clickstream
Тип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

містить обсяг пошуку за ключовим словом, нормалізований за даними clickstream

is_normalized
Тип: boolean | null

дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing

last_updated_time
Тип: string | null

дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00

monthly_searches
Тип: array (object | null)[] | null

помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

search_volume
Тип: integer | null

поточний показник пошукового обсягу ключового слова

keyword_properties
Тип: object | null · Response36Afe1097B20_KeywordProperties

додаткова інформація про ключове слово

core_keyword
Тип: string | null

основне ключове слово в групі
містить основне ключове слово в групі, визначеній алгоритмом кластеризації синонімів
якщо значення — null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні до keyword

detected_language
Тип: string | null

визначена мова ключового слова
указує мову ключового слова, визначену нашою системою

is_another_language
Тип: boolean | null

визначена мова ключового слова відрізняється від заданої
якщо true, мова, задана в запиті, не збігається з мовою, визначеною нашою системою для цього ключового слова

keyword_difficulty
Тип: integer | null

складність потрапляння до першої десятки органічних результатів за ключовим словом
показує ймовірність потрапляння до топ-10 органічних результатів за ключовим словом за логарифмічною шкалою від 0 до 100;
розраховується на основі аналізу, серед інших параметрів, посилальних профілів перших 10 сторінок у SERP;
докладніше про метрику — у цьому посібнику довідкового центру

se_type
Тип: string | null

тип пошукової системи

synonym_clustering_algorithm
Тип: string | null

алгоритм, який використовується для визначення синонімів
можливі значення:
keyword_metrics — алгоритм на основі параметрів keyword_info
text_processing — текстовий алгоритм
якщо значення — null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні до keyword

words_count
Тип: integer | null Формат: int64

кількість слів у ключовому слові
указує, зі скількох слів складається ключове слово

language_code
Тип: string | null

код мови в масиві POST

location_code
Тип: integer | null

код місцеположення в масиві POST

se_type
Тип: string | null

тип пошукової системи

search_intent_info
Тип: object | null · Response36Afe1097B20_SearchIntentInfo

інформація про пошуковий намір для повернутого ключового слова
Докладніше про пошуковий намір — у цій статті довідкового центру

foreign_intent
Тип: array (string | null)[] | null

додаткові пошукові інтенти
можливі значення: informational, navigational, commercial, transactional

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

main_intent
Тип: string | null

основний пошуковий інтент
можливі значення: informational, navigational, commercial, transactional

se_type
Тип: string | null

тип пошукової системи

serp_info
Тип: object | null · Response36Afe1097B20_SerpInfo

дані SERP
значення буде null, якщо ви не встановили поле include_serp_info у true в масиві POST або якщо в нашій базі даних немає даних SERP для цього ключового слова

check_url
Тип: string | null

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

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

previous_updated_time
Тип: string | null

дата й час, що передують останньому оновленню даних SERP
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-10-15 12:57:46 +00:00

se_results_count
Тип: integer | null Формат: int64

кількість результатів пошуку за поверненим ключовим словом

se_type
Тип: string | null

тип пошукової системи

serp_item_types
Тип: array (string | null)[] | null

типи результатів пошуку в SERP
містить типи результатів пошуку (items), знайдених у SERP
можливі типи елементів:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
примітка фактичні результати буде повернено лише для елементів organic, paid, featured_snippet і local_pack

items_count
Тип: integer | null Формат: int64

кількість результатів, повернутих у масиві items

language_code
Тип: string | null

код мови в масиві POST
якщо даних немає, значення — null

location_code
Тип: integer | null

код локації в масиві POST
якщо даних немає, значення — null

offset
Тип: integer | null

поточне значення зміщення

offset_token
Тип: string | null

токен зміщення для наступних запитів
рядок із цього поля можна використати для отримання наступних результатів початкового завдання;
примітка: значення offset_token унікальні для кожного наступного завдання

se_type
Тип: string | null

тип пошукової системи

seed_keyword
Тип: string | null

ключове слово в масиві POST

seed_keyword_data
Тип: object | null · Response36Afe1097B20_KeywordDataInfo

дані ключового слова для початкового ключового слова
поля цього об'єкта ідентичні полям масиву items

avg_backlinks_info
Тип: object | null · Response36Afe1097B20_AvgBacklinksInfo

дані про зворотні посилання для повернутого ключового слова
цей об'єкт містить середню кількість зворотних посилань, сторінок і доменів, що посилаються, а також середні значення рейтингу серед 10 веб-сторінок, що органічно ранжуються за ключовим словом

backlinks
Тип: number | null

середня кількість зворотних посилань

dofollow
Тип: number | null

середня кількість dofollow-посилань

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

main_domain_rank
Тип: number | null

середній рейтинг основного домену
докладніше про метрику та формулу її розрахунку — у цій статті довідкового центру

rank
Тип: number | null

середній ранг
Докладніше про метрику та формулу її розрахунку — у цій статті довідкового центру

referring_domains
Тип: number | null

середня кількість доменів, що посилаються

referring_main_domains
Тип: number | null

середня кількість основних доменів, що посилаються

referring_pages
Тип: number | null

середня кількість сторінок, що посилаються

se_type
Тип: string | null

тип пошукової системи

clickstream_keyword_info
Тип: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

дані clickstream для повернутого ключового слова
щоб отримати результати для цього поля, параметр include_clickstream_data має бути встановлено в true

age_distribution
Тип: object | null

розподіл метрик на основі клікстріму за віком
Докладніше про те, як розраховується ця метрика, — у цій статті довідкового центру

propertyName
Тип: integer | null Формат: int64

Signed 64-bit integers (long type).

gender_distribution
Тип: object | null

розподіл оцінюваних метрик на основі клікстріму за статтю
Докладніше про те, як розраховується ця метрика, — у цій статті довідкового центру

propertyName
Тип: integer | null Формат: int64

Signed 64-bit integers (long type).

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

monthly_searches
Тип: array (object | null)[] | null

щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

search_volume
Тип: integer | null Формат: int64

середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com

keyword
Тип: string | null

повернута ідея ключового слова

keyword_info
Тип: object | null · Response36Afe1097B20_KeywordInfo

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

categories
Тип: array integer[] | null

категорії товарів і послуг
ви можете завантажити повний перелік можливих категорій

competition
Тип: number | null

конкуренція
відносний рівень конкуренції за зазначеним ключовим словом. Значення базується на даних Google Ads і може перебувати в діапазоні від 0 до 1 включно

competition_level
Тип: string | null

рівень конкуренції
відносний рівень конкуренції за зазначеним ключовим словом лише в платній видачі SERP;
можливі значення: LOW, MEDIUM, HIGH
якщо рівень конкуренції невідомий, значення — null;
докладніше про метрику — у цій статті довідкового центру

cpc
Тип: number | null

ціна за клік
середня ціна за клік (USD), історично сплачена за ключове слово

high_top_of_page_bid
Тип: number | null

максимальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 80% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

low_top_of_page_bid
Тип: number | null

мінімальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 20% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті

monthly_searches
Тип: array (object | null)[] | null

щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

se_type
Тип: string | null

тип пошукової системи

search_volume
Тип: integer | null Формат: int64

середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com

search_volume_trend
Тип: object | null · Response36Afe1097B20_SearchVolumeTrend

зміни тренду пошукового обсягу
зміна пошукового обсягу у відсотках порівняно з попереднім періодом

monthly
Тип: integer | null

зміна обсягу пошуку у відсотках порівняно з попереднім місяцем

quarterly
Тип: integer | null

зміна обсягу пошуку у відсотках порівняно з попереднім кварталом

yearly
Тип: integer | null

зміна обсягу пошуку у відсотках порівняно з попереднім роком

keyword_info_normalized_with_bing
Тип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

містить обсяг пошуку за ключовим словом, нормалізований за обсягом пошуку Bing

is_normalized
Тип: boolean | null

дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing

last_updated_time
Тип: string | null

дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00

monthly_searches
Тип: array (object | null)[] | null

помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

search_volume
Тип: integer | null

поточний показник пошукового обсягу ключового слова

keyword_info_normalized_with_clickstream
Тип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

містить обсяг пошуку за ключовим словом, нормалізований за даними clickstream

is_normalized
Тип: boolean | null

дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing

last_updated_time
Тип: string | null

дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00

monthly_searches
Тип: array (object | null)[] | null

помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року

month
Тип: integer | null

місяць

search_volume
Тип: integer | null

середньомісячний показник пошукового обсягу

year
Тип: integer | null

рік

search_volume
Тип: integer | null

поточний показник пошукового обсягу ключового слова

keyword_properties
Тип: object | null · Response36Afe1097B20_KeywordProperties

додаткова інформація про ключове слово

core_keyword
Тип: string | null

основне ключове слово в групі
містить основне ключове слово в групі, визначеній алгоритмом кластеризації синонімів
якщо значення — null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні до keyword

detected_language
Тип: string | null

визначена мова ключового слова
указує мову ключового слова, визначену нашою системою

is_another_language
Тип: boolean | null

визначена мова ключового слова відрізняється від заданої
якщо true, мова, задана в запиті, не збігається з мовою, визначеною нашою системою для цього ключового слова

keyword_difficulty
Тип: integer | null

складність потрапляння до першої десятки органічних результатів за ключовим словом
показує ймовірність потрапляння до топ-10 органічних результатів за ключовим словом за логарифмічною шкалою від 0 до 100;
розраховується на основі аналізу, серед інших параметрів, посилальних профілів перших 10 сторінок у SERP;
докладніше про метрику — у цьому посібнику довідкового центру

se_type
Тип: string | null

тип пошукової системи

synonym_clustering_algorithm
Тип: string | null

алгоритм, який використовується для визначення синонімів
можливі значення:
keyword_metrics — алгоритм на основі параметрів keyword_info
text_processing — текстовий алгоритм
якщо значення — null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні до keyword

words_count
Тип: integer | null Формат: int64

кількість слів у ключовому слові
указує, зі скількох слів складається ключове слово

language_code
Тип: string | null

код мови в масиві POST

location_code
Тип: integer | null

код місцеположення в масиві POST

se_type
Тип: string | null

тип пошукової системи

search_intent_info
Тип: object | null · Response36Afe1097B20_SearchIntentInfo

інформація про пошуковий намір для повернутого ключового слова
Докладніше про пошуковий намір — у цій статті довідкового центру

foreign_intent
Тип: array (string | null)[] | null

додаткові пошукові інтенти
можливі значення: informational, navigational, commercial, transactional

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

main_intent
Тип: string | null

основний пошуковий інтент
можливі значення: informational, navigational, commercial, transactional

se_type
Тип: string | null

тип пошукової системи

serp_info
Тип: object | null · Response36Afe1097B20_SerpInfo

дані SERP
значення буде null, якщо ви не встановили поле include_serp_info у true в масиві POST або якщо в нашій базі даних немає даних SERP для цього ключового слова

check_url
Тип: string | null

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

last_updated_time
Тип: string | null

дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-11-15 12:57:46 +00:00

previous_updated_time
Тип: string | null

дата й час, що передують останньому оновленню даних SERP
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2019-10-15 12:57:46 +00:00

se_results_count
Тип: integer | null Формат: int64

кількість результатів пошуку за поверненим ключовим словом

se_type
Тип: string | null

тип пошукової системи

serp_item_types
Тип: array (string | null)[] | null

типи результатів пошуку в SERP
містить типи результатів пошуку (items), знайдених у SERP
можливі типи елементів:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
примітка фактичні результати буде повернено лише для елементів organic, paid, featured_snippet і local_pack

total_count
Тип: integer | null Формат: int64

загальна кількість результатів у нашій базі даних, що відповідають вашому запиту

result_count
Тип: integer | null Формат: int64

кількість елементів у масиві result

status_code
Тип: integer | null

код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

time
Тип: string | null

час виконання, секунди

tasks_count
Тип: integer | null Формат: int64

кількість завдань у масиві tasks

tasks_error
Тип: integer | null Формат: int64

кількість завдань у масиві tasks, повернутих з помилкою

time
Тип: string | null

загальний час виконання, секунди

version
Тип: string | null

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

post/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "phone",
    "location_code": 2840,
    "language_code": "en",
    "include_serp_info": true,
    "include_seed_keyword": true,
    "limit": 1
  }
]'

Показати схему

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "se_type": null,
          "seed_keyword": null,
          "seed_keyword_data": {
            "se_type": null,
            "keyword": null,
            "location_code": null,
            "language_code": null,
            "keyword_info": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
            "clickstream_keyword_info": "[Max Depth Exceeded]",
            "keyword_properties": "[Max Depth Exceeded]",
            "serp_info": "[Max Depth Exceeded]",
            "avg_backlinks_info": "[Max Depth Exceeded]",
            "search_intent_info": "[Max Depth Exceeded]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Успішна операція

Підказки ключових слів

АвтентифікаціяRequired

DataForSEO

Підказки ключових слів

Довідкові ціни