Compras · Amazon
API de resultados de búsqueda de Amazon
La API de resultados de búsqueda de Amazon te da datos de Amazon en tiempo real en el momento en que los pides, limpios y estructurados, listos para tu propia app, una hoja de cálculo o un asistente de IA. Sin scraping, nada que mantener.
100 solicitudes gratis al mes · sin tarjeta de crédito · una clave de API para todas las plataformas
Datos clave
Actualizado el
La página de búsqueda de Amazon es el escaparate del marketplace: qué ASIN se posicionan para una consulta, cuáles son anuncios de pago, cuánto cuestan y cuántas personas los compraron el mes pasado. La API de resultados de búsqueda de Amazon de everydata.io obtiene esa página en directo para cualquier palabra clave y marketplace y devuelve la cuadrícula de resultados como un array JSON: una llamada por página de resultados, con la misma ordenación que usaría un comprador y con los productos patrocinados marcados o eliminados.
- Plataforma
- Amazon
- Endpoint principal
- /amazon-search-by-keyword-asin
- Cuota por llamada
- 1 solicitud
- Plan gratuito
- 100 solicitudes / mesdespués, desde 30 € / mes
Datos de Amazon, listos para usar
Cada llamada devuelve los productos de exactamente una página de resultados, en el orden del ranking. numberOfProducts indica cuántos productos orgánicos había en esa página, numberOfSponsoredProducts cuántos anuncios se mezclaban con ellos, y resultCount es la cifra propia de Amazon ("over 100,000 results") para la palabra clave. foundProducts y foundSponsoredProducts son listas simples de ASIN, prácticas para comprobar posiciones rápidamente sin tocar los objetos de detalle.
searchProductDetails contiene el detalle de cada resultado: productDescription (el título del resultado), asin, price y retailPrice como números con currency, productRating y countReview, la insignia prime, salesVolume ("50+ bought in past month"), el deliveryMessage que mostró Amazon y un indicador sponsored. dpUrl es el enlace relativo al producto, así que puedes construir una URL canónica con el host del marketplace. starFilterParam y categories muestran los filtros que Amazon ofrecía junto a los resultados.
- Lista de resultados ordenada por página, con recuentos orgánicos y patrocinados por separado
- ASIN, título, precio, precio de lista, moneda, valoración, número de reseñas e URL de imagen de cada resultado
- Disponibilidad de Prime, insignia de volumen de ventas y mensaje de entrega de Amazon por producto
- sortBy: relevanceblender, price-asc-rank, price-desc-rank, review-rank, date-desc-rank
- Limita la consulta a un alias de búsqueda (categoría) o a un ID de nodo de navegación (browseNode)
- excludeSponsored=true para eliminar anuncios; withCache=true para aceptar una página en caché de 10 minutos
- Todos los marketplaces por domainCode: com, de, co.uk, fr, it, es, ca, co.jp, in, com.au, nl, se, pl y más
Lo que los equipos construyen con esto
Seguimiento de posiciones por palabra clave para vendedores y agencias
Obtén una vez al día las páginas 1 a 3 de cada palabra clave que sigues, localiza tus ASIN en foundProducts y guarda la posición. Separa las posiciones orgánicas y patrocinadas con el indicador sponsored.
Cuota de lineal y monitorización de la competencia
Cuenta cuántos resultados de la primera página pertenecen a cada marca en tus consultas principales en amazon.com, .de y .co.uk. salesVolume añade una señal de demanda por competidor.
Descubrimiento de productos y sourcing
Ordena por review-rank o date-desc-rank para encontrar productos bien valorados o recién publicados en un nicho y obtén después los detalles de la lista corta con el endpoint de producto.
Paneles de inteligencia publicitaria
numberOfSponsoredProducts por página y la lista de ASIN patrocinados muestran lo disputada que está una palabra clave y qué competidores compran posiciones para ella.
Solicitud y respuesta de ejemplo
Llama a GET /amz/amazon-search-by-keyword-asin con keyword y domainCode. page es 1 por defecto y llega hasta 400; sortBy es relevanceblender por defecto, el orden "Destacados" de Amazon. El parámetro category acepta un alias de búsqueda exactamente como Amazon lo usa en el desplegable de departamentos: aps para todos los departamentos, electronics, computers, etc. Un alias no válido produce un resultado vacío, no un error, así que mantén una lista de alias conocidos por marketplace.
GET /amz/amazon-search-by-keyword-asin
curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?keyword=laptop&domainCode=com&page=1&sortBy=relevanceblender&excludeSponsored=false" \
-H "x-api-key: YOUR_API_KEY"Respuesta (abreviada)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "relevanceblender",
"domainCode": "com",
"keyword": "laptop",
"numberOfProducts": 26,
"numberOfSponsoredProducts": 6,
"resultCount": 100000,
"selectedCategory": "aps",
"foundSponsoredProducts": [
"B0FGJ14KRX",
"B0GY7F4FDK"
],
"foundProducts": [
"B0HFJ9BNPL",
"B0HF38QXHL"
],
"searchProductDetails": [
{
"productDescription": "Acer Aspire 14 AI Copilot+ PC - Intel Core Ultra 5 226V & 14” WUXGA Touch | 16GB LPDDR5X | 1TB Gen 4 SSD",
"asin": "B0FGJ14KRX",
"countReview": 20,
"imgUrl": "https://m.media-amazon.com/images/I/61kp09SeFyL._AC_UY218_.jpg",
"price": 548.44,
"retailPrice": 0,
"productRating": "4.0 out of 5 stars",
"prime": false,
"dpUrl": "/dp/B0FGJ14KRX",
"salesVolume": "50+ bought in past month",
"sponsored": true,
"currency": "USD"
}
],
"starFilterParam": {
"Apply 4 Stars & Up filter to narrow results": "p_72:1248879011"
},
"currentPage": 1,
"lastPage": 20
}La paginación es explícita: currentPage repite la página que pediste y lastPage es la página más alta que Amazon enlazó en su barra de paginación. Una página típica tiene entre 16 y 60 resultados según el diseño, así que numberOfProducts varía. Las posiciones son el índice en el array searchProductDetails más el desplazamiento de las páginas anteriores: la API no renumera los resultados, así que los patrocinados conservan su posición real salvo que pases excludeSponsored=true.
Los resultados dependen del marketplace y de la ubicación de entrega predeterminada de Amazon para esa solicitud; el deliveryMessage del ejemplo ("Ships to Germany") muestra qué ubicación se aplicó. Un retailPrice de 0 significa que no se mostró precio de lista tachado, y un price de 0 significa que el resultado no llevaba precio, algo que ocurre con artículos con variantes que requieren seleccionar una primero.
La caché de 10 minutos (withCache=true) es útil cuando varias partes de tu sistema lanzan la misma consulta en pocos minutos: la segunda llamada se responde desde la caché y es más rápida. browseNode acota una consulta a un ID de nodo como 10158976011 cuando el alias es demasiado amplio.
Endpoints relacionados
Buscar productos. Búsqueda por palabra clave con paginación, ordenación y filtro de patrocinados.
Detalles del producto por ASIN. Los mismos datos que los detalles del producto, por ASIN y marketplace.
Más vendidos. Lista de más vendidos para la URL de una categoría.
Paga por solicitud, con todas las plataformas incluidas
Una página de resultados equivale a una solicitud, sea cual sea su tamaño. Seguir 100 palabras clave en las tres primeras páginas cada día consume unas 9000 solicitudes al mes: el plan Production (50.000 solicitudes, 80 €) lo cubre con margen para varios marketplaces, y Starter (5000 solicitudes, 30 €) sirve para un conjunto menor de palabras clave solo en la página 1. Los fallos 5xx por parte de Amazon no se cobran.
- Free
- 100 solicitudes / mes
- Starter
- 5000 solicitudes · 30 €
- Production
- 50.000 solicitudes · 80 €
- Business
- 300.000 solicitudes · 300 €
Constrúyelo paso a paso
API de resultados de búsqueda de Amazon: preguntas frecuentes
¿Cuántos productos se devuelven por página?
Exactamente los que Amazon mostró en esa página, normalmente entre 16 y 60 resultados, indicados en numberOfProducts más numberOfSponsoredProducts. Si necesitas un número fijo de resultados, sigue pidiendo páginas hasta tener suficientes o hasta que currentPage llegue a lastPage.
¿Puedo filtrar los resultados por precio o valoración?
No con parámetros directos. Usa sortBy para ordenar por precio o reseñas y filtra después en el cliente por price y productRating. El campo starFilterParam muestra el filtro que ofrecía Amazon, que puedes reutilizar como restricción al estilo de browseNode cuando proceda.
¿Se incluyen los productos patrocinados?
Por defecto sí, cada uno marcado con sponsored: true y listado por separado en foundSponsoredProducts. Usa excludeSponsored=true para recibir solo resultados orgánicos.
¿La búsqueda funciona con códigos EAN o UPC?
Sí: Amazon trata un GTIN como palabra clave y suele devolver el ASIN correspondiente como primer resultado. Es la forma habitual de convertir códigos de barras en ASIN antes de llamar al endpoint de producto.
¿En qué marketplaces puedo buscar?
En todos los marketplaces de Amazon mediante domainCode, de com y de a co.jp, com.au, pl, ae y sg. Los títulos y los mensajes de entrega se devuelven en el idioma del marketplace.
Casos de uso relacionados
Lanza tu primera búsqueda en Amazon
Regístrate gratis, envía una palabra clave y recibe la página de resultados completa en JSON: 100 solicitudes al mes sin coste.