COMMERCE_SERP con site amazon para recibir los productos que muestra una búsqueda, en el orden de la tienda, o COMMERCE_PRODUCT con la url de un producto para leer ese producto. Cada búsqueda o página de producto completada cuesta 1 crédito.
Búsqueda
GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas.
Parámetros
site: Obligatorio.amazon.query: Obligatorio. Consulta de búsqueda, de 1 a 500 caracteres.limit: Entero opcional de 1 a 40, con 20 por defecto.country: Opcional. Por defecto,US, el país de la tienda. Cualquier otro país se rechaza con422 REGION_UNSUPPORTED.
include: incluso include: {} devuelve 422 VALIDATION_ERROR en payload.include antes de reservar créditos.
Ejemplo de respuesta
Campos del resultado
site,queryycountryrepiten la solicitud.returnedCountes el número de elementos deproducts.- Cada producto incluye
rank,productId,titleyurl.productIdes el ASIN.ranksigue el orden predeterminado de la tienda, y se omiten los anuncios que la tienda marca como patrocinados. price,rating,reviewCounteimageUrlaparecen cuando la página de resultados los muestra.pricees un número en lacurrencydel producto (ISO 4217); cuando los tamaños tienen precios distintos, es el más bajo. Una misma búsqueda en Amazon puede mostrar más de una moneda.ratingusa una escala de cinco puntos. Los números de reseñas abreviados, como 999+, se omiten.- Cada búsqueda devuelve productos de la primera página de resultados de la tienda.
Página de producto
Parámetros
url: Obligatorio. Una página de producto de la tienda Amazon, de hasta 2.048 caracteres:amazon.com/dp/{ASIN}oamazon.co.jp/dp/{ASIN}. Lasurlde producto que devuelve una búsqueda sirven tal cual. Los parámetros que no afectan al resultado, como los códigos de seguimiento, se quitan antes de leer la página. También sirven otras direcciones de la misma página, como/gp/product/{ASIN}.country: Opcional. Por defecto, el país de la página:USen amazon.com yJPen amazon.co.jp. Cualquier otro país se rechaza con422 REGION_UNSUPPORTED.
include: incluso include: {} devuelve 422 VALIDATION_ERROR en payload.include antes de reservar créditos.
Ejemplo de respuesta
Campos del resultado
site,country,urlyproductIdidentifican la página.urles la página que se leyó, yproductIdcoincide con el que devuelve una búsqueda.titlesiempre está presente.brand,price,listPrice,currency,inStock,seller,rating,reviewCount,images,description,descriptionImages,specs,options,categoriesygtinaparecen cuando la página los muestra.pricees lo que paga un comprador tal como la página lo muestra al abrirse, antes de cupones y envío, encurrency(ISO 4217).listPricees el precio habitual que la página tacha, presente cuando es mayor queprice.inStockes la disponibilidad del producto.selleres el comerciante que lo vende. Las páginas de amazon.co.jp devuelvencountryJPy precios enJPY. Cuando Amazon no elige una oferta destacada para un producto, la página no muestra precio, así queprice,currency,sellereinStocksalen del primer vendedor con precio de la lista de ofertas del producto.ratingusa una escala de cinco puntos con dos decimales.reviewCountes el número de reseñas.imageslista hasta 30 fotos de la galería del producto, en el orden de la página.descriptiones texto plano con una línea por párrafo, de hasta 10.000 caracteres; el texto que solo aparece dentro de imágenes no se incluye.descriptionImageslista hasta 300 imágenes de la descripción del producto, en el orden de la página. Se incluyen los banners y avisos que los vendedores ponen en su descripción, y el texto dentro de las imágenes no se lee.specslista hasta 100 pares{ name, value }de los detalles del producto.optionslista hasta 20 opciones, como talla o color, cada una con hasta 100values; los demás campos describen la opción con la que se abre la página.categoriesva de la categoría más amplia a la más concreta, con hasta 10 niveles.gtines el UPC, EAN o JAN que indica la página.
Errores y facturación
- Una búsqueda que no devuelve productos termina como tarea fallida.
- Una página de producto que la tienda responde con 404 o 410, como un producto retirado, termina la tarea con
PAGE_UNAVAILABLE, y el mensaje incluye la respuesta de la tienda. Si la tienda rechaza la lectura con 403, 412, 429 o 435, la tarea espera y vuelve a consultar durante un máximo de 6 minutos. Las demás lecturas fallidas, y un rechazo que dura más, terminan conENGINE_NO_RESULT. - Solo se cobran las tareas completadas: 1 crédito por búsqueda o página de producto.