# Obtener resultados de Amazon Sellers por id

**API:** Data API

**Endpoint:** `GET /v1/beta/dataforseo/merchant/amazon/sellers/task_get/advanced/{id}`

**Tags:** DataForSEO

Envuelto en el sobre de DataForSEO: los datos en `tasks[0].result`, el resultado en `tasks[0].status_code`; una solicitud rechazada sigue devolviendo HTTP 200. Esto responde quién más está en el buy box; el producto en sí es `get_dataforseo_merchant_amazon_asin_fetch`. Recúrrelo solo cuando al resultado analizado le falte algo que puedas señalar.

### Referencia de precios

- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.012.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

## Related links

- [UUID](<https://en.wikipedia.org/wiki/Universally_unique_identifier>)
- [guía del centro de ayuda](<https://dataforseo.com/help-center/asin-in-amazon-api>)
- [XPath](<https://en.wikipedia.org/wiki/XPath>)

## 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 | <em>identificador de la tarea</em><br><strong>identificador único de la tarea en nuestro sistema en formato UUID</strong><br>podrás usarlo durante <strong>30 días</strong> para solicitar los resultados de la tarea en cualquier momento |

## Responses

### 200 — Operación correcta

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResponseInfo"
    }
  ]
}
```

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AmazonApplicableVouchersItem

`#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>texto del cupón</em>"
    },
    "fixed_discount": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>valor del descuento fijo</em>"
    },
    "fixed_discount_currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código de moneda del descuento fijo</em>"
    },
    "percentage_discount": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>valor del descuento porcentual</em><br>si el descuento es fijo, el valor será <code>null</code>"
    },
    "important_details": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>detalles importantes sobre los términos de los cupones de descuento</em>"
    }
  }
}
```

### Response36Afe1097B20_AmazonDeliveryInfo

`#/components/schemas/Response36Afe1097B20_AmazonDeliveryInfo`

```json
{
  "type": "object",
  "properties": {
    "delivery_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje que acompaña a la información de entrega tal como la publica el vendedor"
    },
    "delivery_date_from": {
      "type": [
        "string",
        "null"
      ],
      "description": "la fecha más próxima en la que el producto puede enviarse"
    },
    "delivery_date_to": {
      "type": [
        "string",
        "null"
      ],
      "description": "la fecha más tardía en la que el producto puede entregarse"
    },
    "fastest_delivery_date_from": {
      "type": [
        "string",
        "null"
      ],
      "description": "la fecha más próxima en la que el producto puede entregarse con una opción de entrega rápida"
    },
    "fastest_delivery_date_to": {
      "type": [
        "string",
        "null"
      ],
      "description": "la fecha más tardía en la que el producto puede entregarse con una opción de entrega rápida"
    },
    "delivery_price": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo"
        }
      ],
      "description": "precio de la entrega\nprecio de la entrega según la ubicación que especificaste en la solicitud POST;\nsi hay entrega gratuita disponible, el valor es null"
    }
  }
}
```

### Response36Afe1097B20_BaseMerchantAmazonSellersElementItem

`#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonSellersElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "rank_group": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>posición dentro de un grupo de elementos con valores de <code>type</code> idénticos</em><br>las posiciones de los elementos con valores de <code>type</code> diferentes se omiten de <code>rank_group</code>"
    },
    "rank_absolute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em> rank absoluto en la SERP</em><br>posición absoluta entre todos los elementos encontrados en la SERP de Amazon Sellers"
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>alineación del elemento en la SERP</em><br>valores posibles:<br><code>left</code>, <code>right</code>"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>XPath del elemento</em>"
    },
    "seller_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nombre comercial del vendedor</em>"
    },
    "seller_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL de reenvío a la página del vendedor en Amazon</em>"
    },
    "ships_from": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>nombre de la empresa remitente</em>"
    },
    "price": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo"
        }
      ],
      "description": "<em>detalles del precio del producto</em><br>si no hay detalles, el valor será <code>null</code>"
    },
    "percentage_discount": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>valor del descuento porcentual</em>"
    },
    "applicable_vouchers": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_AmazonApplicableVouchersItem"
          }
        ]
      },
      "description": "<em>array de objetos que contienen información sobre los vales aplicables</em>"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement"
        }
      ],
      "description": "<em>detalles de la valoración del vendedor</em><br>índice de popularidad del vendedor basado en las reseñas de los clientes"
    },
    "condition": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>condición del producto</em><br>condición del producto ofrecido por el vendedor"
    },
    "condition_description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>detalles de la condición del producto</em><br>detalles ampliados sobre la condición del producto ofrecido por el vendedor"
    },
    "delivery_info": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_AmazonDeliveryInfo"
        }
      ],
      "description": "<em>información de entrega</em><br>información de entrega, incluidos los intervalos de fechas de entrega gratuita y rápida"
    }
  },
  "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": "la versión actual de la API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado general\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo general\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo total de ejecución, en segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas devueltas con un error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador de la tarea\nidentificador único de la tarea en nuestro sistema en formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado de la tarea\ngenerado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo de la tarea\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo de ejecución, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos en el array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "ruta de la URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contiene los mismos parámetros que especificaste en la solicitud 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": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_MerchantAmazonSellersTaskGetAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "asin": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em><code>asin</code> recibido en un array POST</em><br>obtén más información sobre los ASIN en esta guía del centro de ayuda"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>dominio del motor de búsqueda recibido en un array POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>código de ubicación recibido en un array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código de idioma recibido en un array POST</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL directa a los resultados de Amazon</em><br>puedes usarla para asegurarte de que los resultados proporcionados sean precisos"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>fecha y hora en que se recibió el resultado</em><br>en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>ejemplo:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>título del producto</em><br>título del producto relevante para el <code>asin</code> recibido en un array POST"
    },
    "image": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL de la imagen del producto</em><br>URL de la imagen del producto relevante para el <code>asin</code> recibido en un array POST"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>tipos de resultados de búsqueda encontrados en el SERP de Amazon Sellers</em><br>contiene los tipos de todos los resultados de búsqueda (<code>items</code>) encontrados en el SERP devuelto<br>tipos de elemento posibles:<br><code>amazon_seller_main_item</code>, <code>amazon_seller_item</code>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el número de resultados devueltos en el array <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseMerchantAmazonSellersElementItem"
          }
        ]
      },
      "description": "<em>elementos en el SERP</em>"
    }
  }
}
```

### 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": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_PriceInfo

`#/components/schemas/Response36Afe1097B20_PriceInfo`

```json
{
  "type": "object",
  "properties": {
    "current": {
      "type": [
        "number",
        "null"
      ],
      "description": "precio actual\nindica el precio actual del producto o servicio destacado en el resultado",
      "format": "double"
    },
    "regular": {
      "type": [
        "number",
        "null"
      ],
      "description": "precio habitual\nindica el precio habitual del producto o servicio sin descuentos aplicados",
      "format": "double"
    },
    "max_value": {
      "type": [
        "number",
        "null"
      ],
      "description": "el precio máximo\nel precio máximo del producto o servicio tal como se indica en el resultado",
      "format": "double"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "moneda del precio indicado\ncódigo ISO de la moneda aplicada al precio"
    },
    "is_price_range": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "el precio se proporciona como un intervalo\nindica si un precio se proporciona como un intervalo"
    },
    "displayed_price": {
      "type": [
        "string",
        "null"
      ],
      "description": "cadena de precio del resultado\ncadena de precio sin formato tal como se proporciona en el resultado"
    }
  }
}
```

### Response36Afe1097B20_RatingElement

`#/components/schemas/Response36Afe1097B20_RatingElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "position": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>la alineación del elemento en la SERP de Google Shopping</em><br>valores posibles:<br><code>left</code>, <code>right</code>"
    },
    "rating_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "<i>el tipo de valoración</i><br>aquí puedes encontrar los siguientes elementos: <code>Max5</code>, <code>Percents</code>, <code>CustomMax</code>"
    },
    "value": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>valor de la valoración</em>"
    },
    "votes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>la cantidad de feedback</em>",
      "format": "int64"
    },
    "rating_max": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el valor máximo para un rating_type"
    }
  }
}
```
