Получить расширенные результаты Google Search By Image по id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Получить расширенные результаты Google Search By Image по id
Получает результат поиска Google по изображению из очереди по id. Возвращает keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count и items. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.02.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: object | null · Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_SerpGoogleSearchByImageTaskGetAdvancedTaskInfo
- 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 - imageТип: string | null
_url URL, указанный в массиве POST
- itemТип: array (string | null)[] | null
_types типы результатов поиска в SERP
содержит типы результатов поиска (items), найденных в SERP.
возможные типы элементов:organic,images - itemsТип: array (object | null)[] | null
элементы, представленные в faq_box
- pageТип: integer | null
Integer numbers.
- positionТип: string | null
выравнивание элемента в SERP
может принимать следующие значения:left,right - rankТип: integer | null
_absolute абсолютный ранг в SERP
абсолютная позиция среди всех элементов в SERP - rankТип: integer | null
_group ранг группы в SERP
позиция внутри группы элементов с одинаковыми значениямиtype
позиции элементов с другими значениямиtypeне учитываются вrank_group - 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 левого верхнего угла сниппета результата, где началом координат является левый верхний угол экрана
- titleТип: string | null
заголовок элемента
- typeТип: string | null
тип элемента
- urlТип: string | null
URL поиска с параметрами уточнения
- xpathТип: string | null
- itemsТип: integer | null Формат: int64
_count количество результатов, возвращённых в массиве
items - keywordТип: string | null
ключевое слово, связанное Google с указанным изображением
- languageТип: string | null
_code код языка в массиве POST
- locationТип: integer | null
_code код местоположения в массиве POST
- 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/search_by_image/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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": [
{
"image_url": null,
"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,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"page": null,
"position": null,
"xpath": null,
"title": null,
"url": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}