Жива розширена органічна видача Google
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Жива розширена органічна видача Google
Синхронно повертає ранжовані результати за ключовим словом у Google. Повертає keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count і items. advanced — варіант за замовчуванням; беріть regular, коли потрібен лише ранжований список, і html — лише щоб перевірити, що загубив парсер. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200.
Довідкові ціни
- Тарифікація: вартість відповіді за даними постачальника.
- Довідкова оцінка запиту: USD 0.0175.
- Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.
Довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.
- Тип: array (object | null)[]
- browserТип: integer | null
_screen _height висота екрана браузера необов'язкове поле можна задати власну висоту екрана браузера для розрахунку піксельних позицій для конкретного пристрою; можна вказати в такому діапазоні: 240-9999; за замовчуванням параметр встановлено в: 1080 для десктопа; 640 для мобільних на android; 812 для мобільних на iOS; Примітка: щоб використовувати цей параметр, задайте для calculate_rectangles значення true
- browserТип: integer | null
_screen _resolution _ratio коефіцієнт роздільної здатності екрана браузера необов'язкове поле можна задати власний коефіцієнт роздільної здатності екрана браузера для розрахунку піксельних позицій для конкретного пристрою; можна вказати в такому діапазоні: 0.5-3; за замовчуванням параметр встановлено в: 1 для десктопа; 3 для мобільних на android; 3 для мобільних на iOS; Примітка: щоб використовувати цей параметр, задайте для calculate_rectangles значення true
- browserТип: integer | null Формат: int64
_screen _width ширина екрана браузера необов'язкове поле можна задати власну ширину екрана браузера для розрахунку піксельних позицій для конкретного пристрою; можна вказати в такому діапазоні: 240-9999; за замовчуванням параметр встановлено в: 1920 для десктопа; 360 для мобільних на android; 375 для мобільних на iOS; Примітка: щоб використовувати цей параметр, задайте для calculate_rectangles значення true
- calculateТип: boolean | null
_rectangles розрахунок піксельних позицій для елементів SERP у розширених результатах необов'язкове поле піксельна позиція — це відстань між снипетом результату та верхнім лівим кутом екрана; Докладніше в Help Center>> за замовчуванням параметр встановлено в false; Примітка: за використання цього параметра додатково стягується $0.002
- depthТип: integer | null
глибина парсингу необов'язкове поле кількість результатів у SERP значення за замовчуванням: 10 максимальне значення: 200 З вашого облікового запису стягується плата за кожен SERP, що містить до 10 результатів; Встановлення глибини понад 10 може призвести до додаткових списань, якщо пошукова система повертає понад 10 результатів; Вартість можна розрахувати на сторінці Pricing.
- deviceТип: string | null
тип пристрою необов'язкове поле повертати результати для певного типу пристрою може набувати значень: desktop, mobile значення за замовчуванням: desktop
- findТип: array string[] | null
_targets _in типи елементів SERP для перевірки на цілі необов'язкове поле щоб увімкнути цей параметр, також має бути ввімкнено stop_crawl_on_match указує, які типи елементів SERP слід перевіряти на збіг із цілями якщо не вказано, на цілі перевіряються всі елементи першого рівня з полями url і domain можливі значення: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Примітка: не може містити ті самі типи елементів, що й ignore_targets_in приклад: "find_targets_in": ["organic", "featured_snippet"] докладніше про цей параметр — у нашому Help Center
- groupТип: boolean | null
_organic _results показувати пов'язані результати необов'язкове поле якщо задано true, елемент related_result у відповіді буде надано як сніпет його батьківського органічного результату; якщо задано false, елемент related_result буде надано як окремий органічний результат; значення за замовчуванням: true
- ignoreТип: array string[] | null
_targets _in типи елементів SERP, що виключаються з пошуку цілей необов'язкове поле щоб увімкнути цей параметр, також має бути ввімкнено stop_crawl_on_match указує, які типи елементів SERP слід виключати під час пошуку збігів із цілями можливі значення: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Примітка: не може містити ті самі типи елементів, що й find_targets_in приклад: "ignore_targets_in": ["paid", "images"] докладніше про цей параметр — у нашому Help Center
- keywordТип: string
ключове слово обов'язкове поле у полі keyword можна вказати до 700 символів усі %## буде декодовано (символ ‘+’ декодується в пробіл) якщо в keyword потрібен символ “%”, укажіть його як “%25”; якщо в keyword потрібен символ “+”, укажіть його як “%2B”; якщо це поле містить такі параметри, як ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, вартість завдання множиться на 5 Докладніше про правила й обмеження полів keyword і keywords в API DataForSEO читайте в цій статті довідкового центру
- languageТип: string | null
_code код мови пошукової системи необов'язкове поле, якщо вказано language_name якщо використовуєте це поле, language_name вказувати не потрібно список доступних мов пошукової системи з їхнім language_code можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/google/languages приклад: en
- languageТип: string | null
_name повна назва мови пошукової системи необов'язкове поле, якщо вказано language_code якщо використовуєте це поле, language_code вказувати не потрібно список доступних мов пошукової системи з їхньою language_name можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/google/languages приклад: English
- loadТип: boolean | null
_async _ai _overview завантаження асинхронного AI-огляду необов'язкове поле установіть true, щоб отримувати елементи ai_overview у SERP, навіть якщо вони завантажуються асинхронно; якщо задано false, ви отримаєте елементи ai_overview лише з кешу; значення за замовчуванням: false Примітка: за використання цього параметра додатково стягується $0.002; якщо елемент відсутній або містить "asynchronous_ai_overview": false, усі додаткові списання буде повернено на баланс вашого облікового запису
- locationТип: integer | null
_code код місцезнаходження пошукової системи обов'язкове поле, якщо не вказано location_name або location_coordinate якщо використовуєте це поле, location_name або location_coordinate вказувати не потрібно список доступних місцезнаходжень пошукових систем з їхнім location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/google/locations приклад: 2840
- locationТип: string | null
_coordinate GPS-координати місцезнаходження необов'язкове поле, якщо вказано location_name або location_code якщо використовуєте це поле, location_name або location_code вказувати не потрібно параметр location_coordinate потрібно вказувати у форматі "latitude,longitude,radius" максимальна кількість десяткових цифр для "latitude" і "longitude": 7 мінімальне значення для "radius": 199 (мм) максимальне значення для "radius": 199999 (мм) приклад: 53.476225,-2.243572,200
- locationТип: string | null
_name повна назва місцезнаходження пошукової системи обов'язкове поле, якщо не вказано location_code або location_coordinate якщо використовуєте це поле, location_code або location_coordinate вказувати не потрібно список доступних місцезнаходжень пошукової системи з їхнім location_name можна отримати окремим запитом до https://api.dataforseo.com/v3/serp/google/locations приклад: London,England,United Kingdom
- matchТип: string | null
_type тип відповідності цілі обов'язкове поле, якщо вказано stop_crawl_on_match тип відповідності для match_value можливі значення: domain – конкретний домен або піддомен with_subdomains – основний домен і піддомени wildcard – шаблон із символами підстановки
- matchТип: string | null
_value цільовий домен, піддомен або значення шаблону обов'язкове поле, якщо вказано stop_crawl_on_match укажіть цільовий домен, піддомен або значення шаблону; Примітка: домен або піддомен вказується без протоколу запиту; приклад: "match_value": "dataforseo.com", "match_value": "/blog/post-*"
- maxТип: integer | null
_crawl _pages ліміт обходу сторінок необов'язкове поле кількість сторінок результатів пошуку для обходу максимальне значення: 100 Примітка: плата стягується за кожну проскановану сторінку (10 органічних результатів на сторінку); докладніше про тарифи — на сторінці Pricing; Примітка#2: параметри max_crawl_pages і depth доповнюють один одного; докладніше в нашому довідковому центрі
- osТип: string | null
операційна система пристрою необов'язкове поле якщо в полі device вказано desktop, вибирайте зі значень: windows, macos значення за замовчуванням: windows якщо в полі device вказано mobile, вибирайте зі значень: android, ios значення за замовчуванням: android
- peopleТип: integer | null
_also _ask _click _depth кліки по відповідному елементу необов'язкове поле укажіть глибину кліків по елементу people_also_ask, щоб отримати додаткові елементи people_also_ask_element; Примітка: за кожен клік з облікового запису додатково стягується $0.00015; якщо елемент відсутній або ми виконаємо менше кліків, ніж ви вказали, усі додаткові списання буде повернено на баланс вашого облікового запису можливі значення: від 1 до 4
- removeТип: array string[] | null
_from _url видалення певних параметрів з URL необов'язкове поле за допомогою цього поля можна вказати до 10 параметрів для видалення з URL у результаті приклад: "remove_from_url": ["srsltid"] Примітка: якщо вказано поле target, указані параметри URL буде видалено перед пошуком
- seТип: string | null
_domain домен пошукової системи необов'язкове поле ми автоматично вибираємо відповідний домен пошукової системи згідно з указаними місцеположенням і мовою однак у цьому полі можна задати власний домен пошукової системи приклад: google.co.uk, google.com.au, google.de тощо
- searchТип: string | null
_param додаткові параметри пошукового запиту необов'язкове поле список доступних параметрів і докладні відомості — тут Примітка: такі параметри пошукової системи не підтримуються й автоматично скасовуються, якщо вказані: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopТип: array (object | null)[] | null
_crawl _on _match масив цілей для зупинки обходу необов'язкове поле якщо вказано, відповідь міститиме результати SERP до вказаного match_value включно; у цьому масиві можна вказати до 10 цільових значень приклад: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] докладніше про цей параметр — у нашому довідковому центрі: https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api оплата стягується за кожен SERP, обійдений за вказаними цілями
- matchТип: string | null
_type тип зіставлення цілі обов'язкове поле, якщо вказано stop_crawl_on_match; тип зіставлення для match_value можливі значення: domain, with_subdomains, wildcard
- matchТип: string | null
_value цільовий домен або значення з підстановкою обов'язкове поле, якщо вказано stop_crawl_on_match; укажіть цільовий домен або значення з підстановкою; Примітка: ім'я домену вказується без протоколу запиту; приклад: dataforseo.com
- tagТип: string | null
визначений користувачем ідентифікатор завдання необов'язкове поле обмеження — 255 символів цей параметр дозволяє ідентифікувати завдання та зіставити його з результатом вказане значення tag можна знайти в об'єкті data відповіді
- targetТип: string | null
цільовий домен, піддомен або вебсторінка для отримання результатів необов'язкове поле домен або піддомен вказується без https:// і www. зауважте, що результати завдань щодо target міститимуть лише елементи SERP, які включають рядок url; також можна використовувати символ підстановки (‘’), щоб задати шаблон пошуку в SERP і звузити результати; приклади: example.com - повертає результати для домашньої сторінки сайту з URL, наприклад https://example.com, https://www.example.com/ або https://example.com/; example.com - повертає результати для домену, включно з усіма його сторінками; example.com - повертає результати для всього домену, включно з усіма його сторінками та піддоменами; example.com - повертає результати для домашньої сторінки незалежно від піддомену, наприклад https://en.example.com; example.com/example-page - повертає результати для точного URL; example.com/example-page - повертає результати для всіх URL домену, що починаються з указаного рядка
- targetТип: string | null
_search _mode режим зіставлення цілей необов'язкове поле щоб увімкнути цей параметр, також має бути ввімкнено stop_crawl_on_match визначає, як має зупинятися обхід, якщо в stop_crawl_on_match вказано кілька цілей можливі значення: all, any all — обхід зупиняється лише після виявлення всіх указаних цілей any — обхід зупиняється після виявлення будь-якої однієї цілі значення за замовчуванням: any докладніше про цей параметр — у нашому Help Center
- urlТип: string | null
прямий URL пошукового запиту необов'язкове поле ви можете вказати прямий URL, і ми розберемо його за потрібними полями. Зауважте, що цей спосіб найскладніший для обробки нашим API і потребує вказати в URL точну мову та місцеположення. У більшості випадків ми не рекомендуємо цей спосіб. приклад: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Примітка: такі параметри пошукової системи не підтримуються й автоматично скасовуються, якщо вказані: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Тип: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- Тип: number | null Формат: doublecost
загальна вартість завдань, USD
- Тип: integer | nullstatus
_code загальний код стану. Повний список кодів відповіді можна знайти тут.
- Тип: string | nullstatus
_message загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.
- Тип: array (object | null)[] | nulltasks
масив завдань
- Тип: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- 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
масив результатів
- checkТип: string | null
_url прямий URL до результатів пошукової системи його можна використовувати, щоб переконатися, що ми надали точні результати
- datetimeТип: string | null
дата й час отримання результату у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00” приклад: 2019-11-15 12:57:46 +00:00
- itemТип: array (string | null)[] | null
_types типи результатів пошуку в SERP. містить типи результатів пошуку (items), знайдених у SERP. можливі типи елементів: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, 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, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
- itemsТип: array (object | null)[] | null
дочірні елементи
- pageТип: integer | null
номер сторінки результатів пошуку
указує номер сторінки SERP, на якій розташовано елемент - positionТип: string | null
вирівнювання елемента в SERP
може набувати таких значень:left,right - rectangleТип: object | null · Response36Afe1097B20_AiModeRectangleInfo
параметри прямокутника
містить декартові координати та розміри в пікселях сніпета результату в SERP
дорівнюєnull, якщоcalculate_rectanglesу POST-запиті не встановлено вtrue- heightТип: number | null Формат: double
висота елемента в пікселях
- widthТип: number | null Формат: double
ширина елемента в пікселях
- xТип: number | null Формат: double
координата по осі x координата x лівого верхнього кута фрагмента результату, де початком координат є лівий верхній кут екрана
- yТип: number | null Формат: double
координата по осі y координата y лівого верхнього кута фрагмента результату, де початком координат є лівий верхній кут екрана
- typeТип: string | null
тип елемента
- xpathТип: string | null
XPath елемента
- itemsТип: integer | null Формат: int64
_count кількість результатів, повернутих у масиві items
- keywordТип: string | null
ключове слово, отримане в масиві POST. ключове слово повертається з декодованими %## (символ '+' буде декодовано в пробіл).
- languageТип: string | null
_code код мови в масиві POST
- locationТип: integer | null
_code код локації в масиві POST
- pagesТип: integer | null Формат: int64
_count загалом отримано сторінок результатів пошуку. загальна кількість отриманих SERP у результаті.
- refinementТип: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips чипи уточнення пошуку
- itemsТип: array (object | null)[] | null
дочірні елементи
- domainТип: string | null
домен у SERP
- optionsТип: array (object | null)[] | null
додаткові параметри уточнення пошуку
- domainТип: string | null
домен у SERP
- titleТип: string | null
заголовок елемента
- typeТип: string | null
тип елемента
- urlТип: string | null
URL пошуку з параметрами уточнення
- titleТип: string | null
заголовок елемента
- typeТип: string | null
тип елемента
- urlТип: string | null
URL пошуку з параметрами уточнення
- typeТип: string | null
тип елемента
- xpathТип: string | null
XPath елемента
- seТип: string | null
_domain домен пошукової системи в POST-масиві
- seТип: integer | null Формат: int64
_results _count загальна кількість результатів у SERP
- spellТип: object | null · Response36Afe1097B20_SpellInfo
автокорекція пошукової системи якщо пошукова система надала результати для виправленого ключового слова, ми вкажемо ключове слово, виправлене пошуковою системою, і тип автокорекції
- keywordТип: string | null
ключове слово, отримане в результаті автокорекції пошукової системи результати буде надано для виправленого ключового слова
- typeТип: string | null
тип автокорекції можливі значення: did_you_mean, showing_results_for, no_results_found_for, including_results_for примітка: Yahoo і Yandex підтримують лише такий тип автокорекції: including_results_for
- typeТип: string | null
тип елемента
- 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/serp/google/organic/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"calculate_rectangles": true
}
]'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}