# Получить результаты Amazon Sellers по id **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/merchant/amazon/sellers/task_get/advanced/{id}` **Tags:** DataForSEO Ответ обёрнут в конверт DataForSEO: данные в `tasks[0].result`, результат в `tasks[0].status_code` — отклонённый запрос всё равно возвращает HTTP 200. Это отвечает на вопрос, кто ещё присутствует в buy box; сам товар — `get_dataforseo_merchant_amazon_asin_fetch`. Обращайтесь к нему, только если в разобранном результате не хватает чего-то конкретного. ### Справочная информация о ценах - Тарификация: заявленная стоимость ответа. - Справочная оценка запроса: USD 0.012. - Справочный множитель для клиента: 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`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | идентификатор задачи
уникальный идентификатор задачи в нашей системе в формате UUID
в течение 30 дней вы сможете в любое время запросить по нему результаты задачи | ## Responses ### 200 — Успешная операция Headers: - `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResponseInfo" } ] } ``` ### 400 — Запрос не удалось обработать. Проверьте параметры запроса. ### 401 — Требуется действительный API-ключ Felo. ### 402 — Запрос не может быть выполнен: не выполнено требование биллинга. ### 403 — Аккаунту не разрешено выполнять эту операцию. ### 429 — Достигнут лимит запросов или расходов. ### 502 — Сервис не смог выполнить запрос. ### 503 — API или сервис биллинга временно недоступны. ### 504 — Истекло время ожидания обработки запроса. ### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AmazonApplicableVouchersItem `#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "text": { "type": [ "string", "null" ], "description": "текст ваучера" }, "fixed_discount": { "type": [ "number", "null" ], "description": "размер фиксированной скидки" }, "fixed_discount_currency": { "type": [ "string", "null" ], "description": "код валюты фиксированной скидки" }, "percentage_discount": { "type": [ "number", "null" ], "description": "размер процентной скидки
если скидка фиксированная, значение будет null" }, "important_details": { "type": [ "string", "null" ], "description": "важные сведения об условиях скидочных ваучеров" } } } ``` ### Response36Afe1097B20_AmazonDeliveryInfo `#/components/schemas/Response36Afe1097B20_AmazonDeliveryInfo` ```json { "type": "object", "properties": { "delivery_message": { "type": [ "string", "null" ], "description": "сообщение, сопровождающее информацию о доставке, опубликованную продавцом" }, "delivery_date_from": { "type": [ "string", "null" ], "description": "самая ранняя дата, когда товар может быть отправлен" }, "delivery_date_to": { "type": [ "string", "null" ], "description": "самая поздняя дата, когда товар может быть доставлен" }, "fastest_delivery_date_from": { "type": [ "string", "null" ], "description": "самая ранняя дата, когда товар может быть доставлен с опцией быстрой доставки" }, "fastest_delivery_date_to": { "type": [ "string", "null" ], "description": "самая поздняя дата, когда товар может быть доставлен с опцией быстрой доставки" }, "delivery_price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "цена доставки\nцена доставки с учетом местоположения, указанного в POST-запросе;\nесли доступна бесплатная доставка, значение равно null" } } } ``` ### Response36Afe1097B20_BaseMerchantAmazonSellersElementItem `#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonSellersElementItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "rank_group": { "type": [ "integer", "null" ], "description": "позиция в группе элементов с одинаковыми значениями type
позиции элементов с другими значениями type исключаются из rank_group" }, "rank_absolute": { "type": [ "integer", "null" ], "description": " абсолютный ранг в SERP
абсолютная позиция среди всех элементов, найденных в Amazon Sellers SERP" }, "position": { "type": [ "string", "null" ], "description": "выравнивание элемента в SERP
возможные значения:
left, right" }, "xpath": { "type": [ "string", "null" ], "description": "XPath элемента" }, "seller_name": { "type": [ "string", "null" ], "description": "название компании продавца" }, "seller_url": { "type": [ "string", "null" ], "description": "URL-переадресация на страницу продавца на Amazon" }, "ships_from": { "type": [ "string", "null" ], "description": "название компании отправителя" }, "price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "сведения о цене товара
если сведений нет, значение будет null" }, "percentage_discount": { "type": [ "number", "null" ], "description": "значение процентной скидки" }, "applicable_vouchers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem" } ] }, "description": "массив объектов с информацией о применимых ваучерах" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "сведения о рейтинге продавца
показатель популярности продавца на основе отзывов покупателей" }, "condition": { "type": [ "string", "null" ], "description": "состояние товара
состояние товара, предлагаемого продавцом" }, "condition_description": { "type": [ "string", "null" ], "description": "сведения о состоянии товара
расширенные сведения о состоянии товара, предлагаемого продавцом" }, "delivery_info": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AmazonDeliveryInfo" } ], "description": "информация о доставке
информация о доставке, включая диапазоны дат бесплатной и быстрой доставки" } }, "additionalProperties": false, "discriminator": { "propertyName": "type", "mapping": { "amazon_seller_main_item": "#/components/schemas/Response36Afe1097B20_MerchantAmazonSellerMainItemSerpElementItem", "amazon_seller_item": "#/components/schemas/Response36Afe1097B20_MerchantAmazonSellerItemSerpElementItem" } } } ``` ### 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_MerchantAmazonSellersTaskGetAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResponseInfo` ```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_MerchantAmazonSellersTaskGetAdvancedTaskInfo" } ] }, "description": "массив задач" } } } ] } ``` ### Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResultInfo` ```json { "type": "object", "properties": { "asin": { "type": [ "string", "null" ], "description": "asin, полученный в массиве POST
подробнее об ASIN — в этом руководстве справочного центра" }, "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 к результатам Amazon
его можно использовать, чтобы убедиться, что предоставленные результаты точны" }, "datetime": { "type": [ "string", "null" ], "description": "дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00" }, "title": { "type": [ "string", "null" ], "description": "название товара
название товара, соответствующего asin, полученному в массиве POST" }, "image": { "type": [ "string", "null" ], "description": "URL изображения товара
URL изображения товара, соответствующего asin, полученному в массиве POST" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "типы результатов поиска, найденных в Amazon Sellers SERP
содержит типы всех результатов поиска (items), найденных в возвращённом SERP
возможные типы элементов:
amazon_seller_main_item, amazon_seller_item" }, "items_count": { "type": [ "integer", "null" ], "description": "количество результатов, возвращённых в массиве items", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonSellersElementItem" } ] }, "description": "элементы в SERP" } } } ``` ### Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedTaskInfo` ```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_MerchantAmazonSellersTaskGetAdvancedResultInfo" } ] }, "description": "массив результатов" } } } ] } ``` ### Response36Afe1097B20_PriceInfo `#/components/schemas/Response36Afe1097B20_PriceInfo` ```json { "type": "object", "properties": { "current": { "type": [ "number", "null" ], "description": "текущая цена\nуказывает текущую цену товара или услуги, представленных в результате", "format": "double" }, "regular": { "type": [ "number", "null" ], "description": "обычная цена\nуказывает обычную цену товара или услуги без скидок", "format": "double" }, "max_value": { "type": [ "number", "null" ], "description": "максимальная цена\nмаксимальная цена товара или услуги, указанная в результате", "format": "double" }, "currency": { "type": [ "string", "null" ], "description": "валюта указанной цены\nISO-код валюты, применяемой к цене" }, "is_price_range": { "type": [ "boolean", "null" ], "description": "цена указана в виде диапазона\nуказывает, предоставляется ли цена в виде диапазона" }, "displayed_price": { "type": [ "string", "null" ], "description": "строка цены в результате\nисходная строка цены, как она предоставлена в результате" } } } ``` ### Response36Afe1097B20_RatingElement `#/components/schemas/Response36Afe1097B20_RatingElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "тип элемента" }, "position": { "type": [ "string", "null" ], "description": "выравнивание элемента в Google Shopping SERP
возможные значения:
left, right" }, "rating_type": { "type": [ "string", "null" ], "description": "тип рейтинга
здесь можно найти следующие элементы: Max5, Percents, CustomMax" }, "value": { "type": [ "number", "null" ], "description": "значение рейтинга" }, "votes_count": { "type": [ "integer", "null" ], "description": "количество отзывов", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "максимальное значение для rating_type" } } } ```