# Постановка задач Google Search By Image SERP
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/serp/google/search_by_image/task_post`
**Tags:** DataForSEO
Ставит в очередь страницы, которые Google находит по URL изображения, и возвращает `id` задачи в `tasks[0].id`. Ответ обёрнут в конверт 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": {
"image_url": {
"type": "string",
"description": "URL изображения
обязательное поле
результаты будут основаны на изображении, указанном в этом поле
пример:
https://upload.wikimedia.org/wikipedia/commons/e/ed/Elon_Musk_Royal_Society.jpg
"
},
"location_code": {
"type": "integer",
"description": "код местоположения поисковой системы
обязательное поле, если не указаны location_name или location_coordinate
если используете это поле, location_name или location_coordinate указывать не нужно
список доступных местоположений поисковых систем и их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
пример:
2840
"
},
"language_code": {
"type": "string",
"description": "код языка поисковой системы
обязательное поле, если не указан language_name
если используете это поле, language_name указывать не нужно
список доступных языков поисковой системы и их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesпример:en
"
},
"pingback_url": {
"type": [
"string",
"null"
],
"description": "URL уведомления о завершении задачи
необязательное поле
когда задача будет выполнена, мы отправим GET-запрос на указанный вами URL
строку «$id» можно использовать как переменную $id, а «$tag» — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения.
пример:
http://your-server.com/pingscript?id=$id
http://your-server.com/pingscript?id=$id&tag=$tag
Примечание: специальные символы в pingback_url будут urlencoded;
в частности, символ # кодируется как %23
Подробнее см. в Help Center
"
},
"postback_url": {
"type": [
"string",
"null"
],
"description": "URL для отправки результатов задачи
необязательное поле
когда задача будет выполнена, мы отправим POST-запрос с результатами, сжатыми в формате gzip, на указанный вами postback_url
строку «$id» можно использовать как переменную $id, а «$tag» — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения.
пример:
http://your-server.com/postbackscript?id=$id
http://your-server.com/postbackscript?id=$id&tag=$tag
Примечание: специальные символы в postback_url будут urlencoded;
в частности, символ # кодируется как %23
Подробнее см. в Help Center
"
},
"postback_data": {
"type": "string",
"description": "тип данных postback_url
обязательное поле, если указан postback_url
соответствует типу данных, который будет отправлен на ваш сервер
возможные значения:
advanced, html
"
},
"priority": {
"type": [
"integer",
"null"
],
"description": "приоритет задачи
необязательное поле
может принимать следующие значения:
1 — обычный приоритет выполнения (устанавливается по умолчанию)
2 — высокий приоритет выполнения
За задачи с высоким приоритетом выполнения взимается дополнительная плата.Стоимость можно рассчитать на странице тарифов."
},
"location_name": {
"type": "string",
"description": "
полное название местоположения поисковой системы
обязательное поле, если не указаны location_code или location_coordinate
если используете это поле, location_code или location_coordinate указывать не нужно
список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
пример:
London,England,United Kingdom
"
},
"language_name": {
"type": "string",
"description": "полное название языка поисковой системы
обязательное поле, если не указан language_code
если используете это поле, language_code указывать не нужно
список доступных языков поисковой системы и их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
пример:
English
"
},
"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": "дополнительные параметры поискового запроса
необязательное поле
список доступных параметров и подробности — здесь
"
},
"calculate_rectangles": {
"type": [
"boolean",
"null"
],
"description": "расчёт пиксельных позиций для элементов SERP в расширенных результатах
необязательное поле
пиксельная позиция — это расстояние между сниппетом результата и верхним левым углом экрана;
Подробнее в Help Center>>
по умолчанию параметр установлен в false
Примечание: если задать true, стоимость задачи умножается на 2
"
},
"browser_screen_width": {
"type": [
"integer",
"null"
],
"description": "ширина экрана браузера
необязательное поле
можно задать собственную ширину экрана браузера для расчёта пиксельных позиций для конкретного устройства;
по умолчанию параметр установлен в 1920;
Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true
",
"format": "int64"
},
"browser_screen_height": {
"type": [
"integer",
"null"
],
"description": "высота экрана браузера
необязательное поле
можно задать собственную высоту экрана браузера для расчёта пиксельных позиций для конкретного устройства;
по умолчанию параметр установлен в 1080;
Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true
"
},
"browser_screen_resolution_ratio": {
"type": [
"integer",
"null"
],
"description": "коэффициент разрешения экрана браузера
необязательное поле
можно задать собственный коэффициент разрешения экрана браузера для расчёта пиксельных позиций для конкретного устройства;
по умолчанию параметр установлен в 1;
Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true
"
},
"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,
"image_url": "https://dataforseo.com/wp-content/uploads/2016/11/data_for_seo_light_429.png"
}
]
}
]
},
"example": [
{
"language_code": "en",
"location_code": 2840,
"image_url": "https://dataforseo.com/wp-content/uploads/2016/11/data_for_seo_light_429.png"
}
]
}
```
## Responses
### 200 — Успешная операция
Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleSearchByImageTaskPostResponseInfo"
}
]
}
```
### 400 — Запрос не удалось обработать. Проверьте параметры запроса.
### 401 — Требуется действительный API-ключ Felo.
### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.
### 403 — Аккаунту не разрешено выполнять эту операцию.
### 429 — Достигнут лимит запросов или расходов.
### 502 — Сервис не смог выполнить запрос.
### 503 — API или сервис биллинга временно недоступны.
### 504 — Истекло время ожидания обработки запроса.
### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
**application/json**
Schema:
```json
{}
```
## Schema definitions
### 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_SerpGoogleSearchByImageTaskPostResponseInfo
`#/components/schemas/Response36Afe1097B20_SerpGoogleSearchByImageTaskPostResponseInfo`
```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_SerpGoogleSearchByImageTaskPostTaskInfo"
}
]
},
"description": "массив задач"
}
}
}
]
}
```
### Response36Afe1097B20_SerpGoogleSearchByImageTaskPostTaskInfo
`#/components/schemas/Response36Afe1097B20_SerpGoogleSearchByImageTaskPostTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"object",
"null"
],
"description": "массив результатов
в этом случае значение будет null"
}
}
}
]
}
```