Живая расширенная органическая выдача 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
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
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]"
}
]
}
]
}
]
}