DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ключові слова для сайту
Ключові слова, за якими ранжується сайт target. Повертає se_type, target, 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.
- Тип: array (object | null)[]
- 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для зіставлення будь-якого рядка з нуля або більше символів
зверніть увагу, що фільтрувати результати заrelevanceне можна
приклад:["keyword_info.search_volume",">",0]
Докладніше про фільтри — у Dataforseo Labs - Filters або в цьому посібнику довідкового центруПорожній об'єкт - includeТип: boolean | null
_clickstream _data увімкнути або виключити дані клікстрім-метрик у результаті
необов'язкове поле
якщо параметр установлено вtrue, ви отримаєте у відповіді поляclickstream_keyword_info,keyword_info_normalized_with_clickstreamіkeyword_info_normalized_with_bing
значення за замовчуванням:false
у разі ввімкнення цього параметра вартість запиту подвоюєтьсяДокладніше про те, як розраховуються метрики на основі клікстріму, — у цій статті довідкового центру
- includeТип: boolean | null
_serp _info включити дані SERP для кожного ключового слова
необов'язкове поле
якщо встановленоtrue, ми повернемо масивserp_info, що містить дані SERP (кількість результатів пошуку, релевантний URL і функції SERP) для кожного ключового слова у відповіді
значення за замовчуванням:false - includeТип: boolean | null
_subdomains вказує, чи буде включено піддомени в пошук
необов'язкове поле
якщо заданоfalse, піддомени буде проігноровано
значення за замовчуванням:true - languageТип: string | null
_code код мови
необов'язкове поле
якщо використовуєте це поле,language_nameвказувати не потрібно
список доступних мов з їхнімиlanguage_codeможна отримати окремим запитомhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
приклад:en
Примітка: якщо поле не вказано, за замовчуванням використовується мова з найбільшою кількістю записів ключових слів у вказаному місцезнаходженні;
щоб визначити мову за замовчуванням, зверніться до поляavailable_languages.keywordsендпоінта Locations and Languages - languageТип: string | null
_name повна назва мови
необов'язкове поле
якщо використовуєте це поле,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Тип: integer
_code унікальний ідентифікатор місцезнаходження
обов'язкове поле, якщо не вказаноlocation_name
Примітка: необхідно вказатиlocation_nameабоlocation_code
список доступних місцезнаходжень ізlocation_codeможна отримати окремим запитомhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
приклад:2840 - locationТип: string
_name повна назва місцезнаходження
обов'язкове поле, якщо не вказаноlocation_code
Примітка: необхідно вказатиlocation_nameабо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Тип: string | null
_token токен зміщення для наступних запитів
необов'язкове поле
надається в тому самому полі відповіді на кожен запит;
використовуйте цей параметр, щоб уникнути тайм-аутів під час спроби отримати понад 10 000 результатів в одному запиті;
вказавши унікальне значенняoffset_tokenз масиву відповіді, ви отримаєте наступні результати початкового завдання;
значенняoffset_tokenунікальні для кожного наступного завдання
Примітка: якщо в запиті вказаноoffset_token, під час обробки завдання всі інші параметри, крімlimit, не враховуються.
Докладніше про цей параметр — у довідковому центрі - orderТип: array string[] | null
_by правила сортування результатів
необов'язкове поле
для сортування результатів можна використовувати ті самі значення, що й у масивіfilters
можливі типи сортування:asc- результати сортуються за зростаннямdesc- результати сортуються за спаданням
для задання параметра сортування використовуйте комуправило за замовчуванням:
["relevance,desc"]
relevance використовується як правило сортування за замовчуванням, щоб надавати найближчі ідеї ключових слів. Рекомендуємо використовувати це правило сортування для отримання високорелевантних пошукових запитів. Примітка:relevance— лише наш внутрішній системний ідентифікатор, тому його не можна використовувати як фільтр, і ви не знайдете це поле в масивіresult. Оцінка релевантності ґрунтується на принципі, подібному до того, що використовується в ендпоінті the Keywords For Keywords.в одному запиті можна задати не більше трьох правил сортування
кілька правил сортування потрібно розділяти комою
приклад:["relevance,desc","keyword_info.search_volume,desc"] - tagТип: string | null
визначений користувачем ідентифікатор завдання
необов'язкове поле
обмеження — 255 символів
цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
вказане значенняtagви знайдете в об'єктіdataвідповіді - targetТип: string
доменне ім'я або URL сторінки
обов'язкове поле
доменне ім'я цільового вебсайту, піддомен або URL цільової вебсторінки;
доменне ім'я вказується безhttps://абоwww.;
піддомен вказується безhttps://;
URL вебсторінки вказується зhttps://абоwww.
Примітка: якщо вказати URL вебсторінки безhttps://абоwww., результат буде повернуто для всього домену, а не для конкретної сторінки
- Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordsForSiteLiveResponseInfo200
- Тип: number | null Формат: doublecost
загальна вартість завдань, USD
- Тип: integer | nullstatus
_code загальний код стану. Повний список кодів відповіді можна знайти тут.
- Тип: string | nullstatus
_message загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.
- Тип: array (object | null)[] | nulltasks
масив завдань
- Тип: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordsForSiteLiveTaskInfo
- costТип: number | null Формат: double
загальна вартість завдань, USD
- dataТип: object | null
містить ті самі параметри, які ви вказали в POST-запиті
- propertyТип: object | null
Name
- idТип: string | null
ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID
- pathТип: array (string | null)[] | null
шлях URL
- resultТип: array (object | null)[] | null
масив результатів
- itemsТип: array (object | null)[] | null
містить ідеї ключових слів і пов'язані дані
- avgТип: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info дані про зворотні посилання для повернутого ключового слова
цей об'єкт містить середню кількість зворотних посилань, сторінок і доменів, що посилаються, а також середні значення рейтингу серед 10 веб-сторінок, що органічно ранжуються за ключовим словом- backlinksТип: number | null
середня кількість зворотних посилань
- dofollowТип: number | null
середня кількість dofollow-посилань
- lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - mainТип: number | null
_domain _rank - rankТип: number | null
- referringТип: number | null
_domains середня кількість доменів, що посилаються
- referringТип: number | null
_main _domains середня кількість основних доменів, що посилаються
- referringТип: number | null
_pages середня кількість сторінок, що посилаються
- seТип: string | null
_type тип пошукової системи
- clickstreamТип: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info дані clickstream для повернутого ключового слова
щоб отримати результати для цього поля, параметрinclude_clickstream_dataмає бути встановлено вtrue- ageТип: object | null
_distribution - propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- genderТип: object | null
_distribution - propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - monthlyТип: array (object | null)[] | null
_searches щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- searchТип: integer | null Формат: int64
_volume середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com
- keywordТип: string | null
повернута ідея ключового слова
- keywordТип: object | null · Response36Afe1097B20_KeywordInfo
_info дані за ключовим словом для повернутої ідеї ключового слова
- categoriesТип: array integer[] | null
- competitionТип: number | null
конкуренція
відносний рівень конкуренції за зазначеним ключовим словом. Значення базується на даних Google Ads і може перебувати в діапазоні від 0 до 1 включно - competitionТип: string | null
_level - cpcТип: number | null
ціна за клік
середня ціна за клік (USD), історично сплачена за ключове слово - highТип: number | null
_top _of _page _bid максимальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 80% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті - lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - lowТип: number | null
_top _of _page _bid мінімальна ставка для показу оголошення у верхній частині першої сторінки
означає значення, що перевищує приблизно 20% мінімальних ставок, за яких показувалися оголошення (на основі статистики Google Ads для рекламодавців)
значення може відрізнятися залежно від локації, зазначеної в POST-запиті - monthlyТип: array (object | null)[] | null
_searches щомісячні пошуки
являє (приблизну) кількість пошуків за цією ключовою ідеєю (за наявними даними за останні дванадцять місяців) для вказаних географічних місцезнаходжень- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- seТип: string | null
_type тип пошукової системи
- searchТип: integer | null Формат: int64
_volume середньомісячний показник пошукового обсягу
являє (приблизну) кількість пошуків за цією ключовою ідеєю на google.com - searchТип: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend зміни тренду пошукового обсягу
зміна пошукового обсягу у відсотках порівняно з попереднім періодом- monthlyТип: integer | null
зміна обсягу пошуку у відсотках порівняно з попереднім місяцем
- quarterlyТип: integer | null
зміна обсягу пошуку у відсотках порівняно з попереднім кварталом
- yearlyТип: integer | null
зміна обсягу пошуку у відсотках порівняно з попереднім роком
- keywordТип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing містить обсяг пошуку за ключовим словом, нормалізований за обсягом пошуку Bing
- isТип: boolean | null
_normalized дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing
- lastТип: string | null
_updated _time дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00
- monthlyТип: array (object | null)[] | null
_searches помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року
- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- searchТип: integer | null
_volume поточний показник пошукового обсягу ключового слова
- keywordТип: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream містить обсяг пошуку за ключовим словом, нормалізований за даними clickstream
- isТип: boolean | null
_normalized дані ключового слова нормалізовано якщо true, значення нормалізовано за даними Bing
- lastТип: string | null
_updated _time дата й час оновлення набору даних у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00
- monthlyТип: array (object | null)[] | null
_searches помісячні показники пошукового обсягу масив об'єктів із показниками пошукового обсягу для певного місяця року
- monthТип: integer | null
місяць
- searchТип: integer | null
_volume середньомісячний показник пошукового обсягу
- yearТип: integer | null
рік
- searchТип: integer | null
_volume поточний показник пошукового обсягу ключового слова
- keywordТип: object | null · Response36Afe1097B20_KeywordProperties
_properties додаткова інформація про ключове слово
- coreТип: string | null
_keyword основне ключове слово в групі
містить основне ключове слово в групі, визначеній алгоритмом кластеризації синонімів
якщо значення —null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні доkeyword - detectedТип: string | null
_language визначена мова ключового слова
указує мову ключового слова, визначену нашою системою - isТип: boolean | null
_another _language визначена мова ключового слова відрізняється від заданої
якщоtrue, мова, задана в запиті, не збігається з мовою, визначеною нашою системою для цього ключового слова - keywordТип: integer | null
_difficulty складність потрапляння до першої десятки органічних результатів за ключовим словом
показує ймовірність потрапляння до топ-10 органічних результатів за ключовим словом за логарифмічною шкалою від 0 до 100;
розраховується на основі аналізу, серед інших параметрів, посилальних профілів перших 10 сторінок у SERP;
докладніше про метрику — у цьому посібнику довідкового центру - seТип: string | null
_type тип пошукової системи
- synonymТип: string | null
_clustering _algorithm алгоритм, який використовується для визначення синонімів
можливі значення:keyword_metrics— алгоритм на основі параметрівkeyword_infotext_processing— текстовий алгоритм
якщо значення —null, у нашій базі немає ключових слів, які відповідний алгоритм міг би визначити як синонімічні доkeyword - wordsТип: integer | null Формат: int64
_count кількість слів у ключовому слові
указує, зі скількох слів складається ключове слово
- languageТип: string | null
_code код мови в масиві POST
- locationТип: integer | null
_code код місцеположення в масиві POST
- seТип: string | null
_type тип пошукової системи
- searchТип: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignТип: array (string | null)[] | null
_intent додаткові пошукові інтенти
можливі значення:informational,navigational,commercial,transactional - lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - mainТип: string | null
_intent основний пошуковий інтент
можливі значення:informational,navigational,commercial,transactional - seТип: string | null
_type тип пошукової системи
- serpТип: object | null · Response36Afe1097B20_SerpInfo
_info дані SERP
значення будеnull, якщо ви не встановили полеinclude_serp_infoуtrueв масиві POST або якщо в нашій базі даних немає даних SERP для цього ключового слова- checkТип: string | null
_url прямий URL до результатів пошукової системи
за його допомогою можна переконатися, що ми надали точні результати - lastТип: string | null
_updated _time дата й час оновлення даних за ключовим словом
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - previousТип: string | null
_updated _time дата й час, що передують останньому оновленню даних SERP
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-10-15 12:57:46 +00:00 - seТип: integer | null Формат: int64
_results _count кількість результатів пошуку за поверненим ключовим словом
- seТип: string | null
_type тип пошукової системи
- serpТип: array (string | null)[] | null
_item _types типи результатів пошуку в 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Тип: integer | null Формат: int64
_count кількість результатів, повернутих у масиві
items - languageТип: string | null
_code код мови в масиві POST
- locationТип: integer | null
_code код місцеположення в масиві POST
- offsetТип: integer | null
поточне значення зміщення
- offsetТип: string | null
_token токен зміщення для наступних запитів
рядок із цього поля можна використати для отримання наступних результатів початкового завдання;
примітка: значенняoffset_tokenунікальні для кожного наступного завдання - seТип: string | null
_type тип пошукової системи
- targetТип: string | null
цільовий домен у POST-масиві
- totalТип: integer | null Формат: int64
_count загальна кількість результатів у нашій базі даних, що відповідають вашому запиту
- resultТип: integer | null Формат: int64
_count кількість елементів у масиві result
- statusТип: integer | null
_code код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.
- statusТип: string | null
_message інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.
- timeТип: string | null
час виконання, секунди
- Тип: integer | null Формат: int64tasks
_count кількість завдань у масиві tasks
- Тип: integer | null Формат: int64tasks
_error кількість завдань у масиві tasks, повернутих з помилкою
- Тип: string | nulltime
загальний час виконання, секунди
- Тип: string | nullversion
поточна версія API
application/json - 400
Не вдалося обробити запит. Перевірте параметри запиту.
- 401
Потрібен дійсний API-ключ Felo.
- 402
Запит неможливо виконати: умови білінгу не виконано.
- 403
Обліковий запис не має дозволу на цю операцію.
- 429
Досягнуто ліміту запитів або витрат.
- 502
Служба не змогла виконати запит.
- 503
API або служба білінгу тимчасово недоступні.
- 504
Час очікування обробки запиту вичерпано.
- default
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keywords_for_site/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "apple.com",
"language_code": "en",
"location_code": 2840,
"include_serp_info": true,
"include_subdomains": true,
"filters": [
"serp_info.se_results_count",
">",
0
],
"limit": 3
}
]'
{
"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,
"target": null,
"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]"
}
]
}
]
}
]
}