# Live-результаты Google Images SERP **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/google/images/live/advanced` **Tags:** DataForSEO Синхронно возвращает результаты изображений по ключевому слову в 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.02. - Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента. Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "keyword": { "type": "string", "description": "

ключевое слово

обязательное поле

в поле keyword можно указать до 700 символов

все %## будут декодированы (символ '+' декодируется в пробел)

если в keyword нужен символ \"%\", укажите его как \"%25\";

если в keyword нужен символ “+”, укажите его как “%2B”;

если это поле содержит такие параметры, как 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', стоимость задачи умножается на 5

Примечание: запросы с параметром «cache:» не поддерживаются и возвращают ошибку валидации


Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в этой статье справочного центра

" }, "location_code": { "type": "integer", "description": "

код местоположения поисковой системы

обязательное поле, если не указаны location_name или location_coordinate

если используете это поле, location_name или location_coordinate указывать не нужно

список доступных местоположений поисковых систем с их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/locations

пример:

2840

" }, "language_code": { "type": "string", "description": "

код языка поисковой системы

обязательное поле, если не указан language_name

если используете это поле, language_name указывать не нужно

список доступных языков поисковой системы с их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/languages

пример:

en

" }, "depth": { "type": [ "integer", "null" ], "description": "

глубина парсинга

необязательное поле

количество результатов в SERP

значение по умолчанию: 100

максимальное значение: 200


С каждого SERP, содержащего до 100 результатов, с вашего аккаунта взимается плата;

Установка глубины выше 100 может привести к дополнительным расходам, если поисковая система вернёт больше 100 результатов;

Если указанная глубина превышает количество результатов в ответе, разница автоматически возвращается на баланс вашего аккаунта;

Стоимость можно рассчитать на странице тарифов." }, "location_name": { "type": "string", "description": "

полное название местоположения поисковой системы

обязательное поле, если не указаны location_code или location_coordinate

если используете это поле, location_code или location_coordinate указывать не нужно

список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/locations

пример:

London,England,United Kingdom

" }, "language_name": { "type": "string", "description": "

полное название языка поисковой системы

обязательное поле, если не указан language_code

если используете это поле, language_code указывать не нужно

список доступных языков поисковой системы с их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/google/languages

пример:

English

" }, "os": { "type": [ "string", "null" ], "description": "

операционная система устройства

необязательное поле

учтите, что этот API предоставляет результаты только для десктопа

выбирайте из значений: windows, macos

значение по умолчанию: windows

" }, "tag": { "type": [ "string", "null" ], "description": "

пользовательский идентификатор задачи

необязательное поле

ограничение — 255 символов

этот параметр позволяет идентифицировать задачу и сопоставить её с результатом

указанное значение tag вы найдёте в объекте data ответа

" }, "max_crawl_pages": { "type": [ "integer", "null" ], "description": "

лимит обхода страниц

необязательное поле

количество страниц результатов поиска для обхода

максимальное значение: 100

Примечание: параметры max_crawl_pages и depth дополняют друг друга;

подробнее — в нашем справочном центре

" }, "search_param": { "type": [ "string", "null" ], "description": "

дополнительные параметры поискового запроса

необязательное поле

Список доступных параметров и дополнительные сведения см. здесь.

" }, "url": { "type": [ "string", "null" ], "description": "

прямой URL поискового запроса

необязательное поле

вы можете указать прямой URL, и мы разберём его по нужным полям. Учтите, что этот способ самый сложный для обработки нашим API и требует указать в URL точный язык и местоположение. В большинстве случаев мы не рекомендуем этот способ.

пример:

https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

" }, "location_coordinate": { "type": "string", "description": "

GPS-координаты местоположения

обязательное поле, если не указаны location_name или location_code

если используете это поле, location_name или location_code указывать не нужно

параметр location_coordinate указывается в формате \"latitude,longitude,radius\"

максимальное количество десятичных цифр для \"latitude\" и \"longitude\": 7

минимальное значение для \"radius\": 199.9 (мм)

максимальное значение для \"radius\": 199999 (мм)

пример:

53.476225,-2.243572,200

" }, "se_domain": { "type": [ "string", "null" ], "description": "

домен поисковой системы

необязательное поле

Мы автоматически выбираем подходящий домен поисковой системы в соответствии с указанными вами местоположением и языком. Однако в этом поле можно задать собственный домен поисковой системы

пример:

google.co.uk, google.com.au, google.de и т. д.

" } }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "albert einstein" } ] } ] }, "example": [ { "language_code": "en", "location_code": 2840, "keyword": "albert einstein" } ] } ``` ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleImagesLiveAdvancedResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AmazonLabelElement `#/components/schemas/Response36Afe1097B20_AmazonLabelElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок элемента" }, "url": { "type": [ "string", "null" ], "description": "URL поиска с параметрами уточнения" }, "domain": { "type": [ "string", "null" ], "description": "домен в SERP" } } } ``` ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "текущая версия API" }, "status_code": { "type": [ "integer", "null" ], "description": "общий код состояния.\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "общее информационное сообщение.\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "общее время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "число задач в массиве tasks, возвращённых с ошибкой", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "идентификатор задачи\nуникальный идентификатор задачи в нашей системе в формате UUID" }, "status_code": { "type": [ "integer", "null" ], "description": "код состояния задачи\nформируется DataForSEO, может находиться в диапазоне 10000-60000\nПолный список кодов ответа можно найти здесь." }, "status_message": { "type": [ "string", "null" ], "description": "информационное сообщение задачи\nПолный список общих информационных сообщений можно найти здесь." }, "time": { "type": [ "string", "null" ], "description": "время выполнения, секунды" }, "cost": { "type": [ "number", "null" ], "description": "общая стоимость задач, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "число элементов в массиве result", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "путь URL" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "содержит те же параметры, что вы указали в POST-запросе" } } } ``` ### Response36Afe1097B20_BaseSerpApiGoogleImagesElementItem `#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleImagesElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "rank_group": { "type": [ "integer", "null" ], "description": "групповой ранг в SERP
позиция внутри группы элементов с одинаковыми значениями type
позиции элементов с другими значениями type не учитываются в rank_group" }, "rank_absolute": { "type": [ "integer", "null" ], "description": " абсолютный рейтинг в SERP для целевого домена
абсолютная позиция среди всех элементов в SERP" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "carousel": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleImagesCarouselElementItem", "images_search": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleImagesImagesSearchElementItem", "related_searches": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleImagesRelatedSearchesElementItem" } } } ``` ### Response36Afe1097B20_RefinementChipsElement `#/components/schemas/Response36Afe1097B20_RefinementChipsElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "title": { "type": [ "string", "null" ], "description": "заголовок элемента" }, "url": { "type": [ "string", "null" ], "description": "URL поиска с параметрами уточнения" }, "domain": { "type": [ "string", "null" ], "description": "домен в SERP" }, "options": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement" } ] }, "description": "дополнительные параметры уточнения поиска" } } } ``` ### Response36Afe1097B20_RefinementChipsInfo `#/components/schemas/Response36Afe1097B20_RefinementChipsInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement" } ] }, "description": "дочерние элементы" } } } ``` ### Response36Afe1097B20_SerpGoogleImagesLiveAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleImagesLiveAdvancedResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleImagesLiveAdvancedTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_SerpGoogleImagesLiveAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleImagesLiveAdvancedResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в POST-массиве
ключевое слово возвращается с декодированным %## (символ '+' будет декодирован как пробел)" }, "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "se_domain": { "type": [ "string", "null" ], "description": "домен поисковой системы в массиве POST" }, "location_code": { "type": [ "integer", "null" ], "description": "код местоположения в массиве POST" }, "language_code": { "type": [ "string", "null" ], "description": "код языка в массиве POST" }, "check_url": { "type": [ "string", "null" ], "description": "прямой URL к результатам поисковой системы
его можно использовать, чтобы убедиться, что мы предоставили точные результаты" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "spell": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo" } ], "description": "автокоррекция поисковой системы
если поисковая система предоставила результаты по исправленному ключевому слову, мы укажем исправленное поисковой системой ключевое слово и тип автокоррекции" }, "refinement_chips": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo" } ], "description": "чипы уточнения поиска" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы результатов поиска в SERP
содержит типы результатов поиска (items), найденных в SERP.
возможные типы элементов:
carousel, images_search, related_searches" }, "se_results_count": { "type": [ "integer", "null" ], "description": " общее количество результатов в SERP", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleImagesElementItem" } ] }, "description": "элементы, входящие в элемент" } } } ``` ### Response36Afe1097B20_SerpGoogleImagesLiveAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_SerpGoogleImagesLiveAdvancedTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleImagesLiveAdvancedResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_SpellInfo `#/components/schemas/Response36Afe1097B20_SpellInfo` ```json { "properties": { "keyword": { "type": [ "string", "null" ], "description": "ключевое слово, полученное в результате автокоррекции поисковой системы\nрезультаты будут предоставлены для исправленного ключевого слова" }, "type": { "type": [ "string", "null" ], "description": "тип автокоррекции\nвозможные значения:\ndid_you_mean, showing_results_for, no_results_found_for, including_results_for\nпримечание: Yahoo и Yandex поддерживают только следующий тип автокоррекции:\nincluding_results_for" } } } ```