API de plataforma de EveryData
API de Amazon
Investiga productos, reseñas, listas de más vendidos y vendedores de Amazon sin confundir un ASIN con una cuenta o una posición de ventas. El dominio de mercado y el idioma son entradas separadas.
Un enlace con ASIN identifica un producto, pero la disponibilidad, el precio y las reseñas pueden variar por marketplace. Los rankings son fotografías de una lista o búsqueda; no equivalen a unidades vendidas ni crean un historial automático.
- Endpoint
- POST /api/v1/social
- Funciones
- 5
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Amazon por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en un marketplace de Amazon Pasa el producto en | keyword | domain, lang | Entrega síncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | asin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · rank |
profileConsultar un producto de Amazon por ASIN
| url | lang | Entrega síncrona | — | $1.39 por 1.000 solicitudes | asin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · rank |
reviewsLeer reseñas del producto en el mercado correcto Usa la | url | domain | Entrega síncrona | — | $1.39 por 1.000 solicitudes | review_id · title · text · rating · rating_scale · posted_at · helpful_count · is_verified_purchase · is_vine · variant · country · url · author_name · product_asin · platform |
bestsellersConsultar una lista de más vendidos de Amazon En | keyword | lang | Entrega síncrona | El catálogo declara `defaultLimit = 20` y `maxLimit = 100` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · name · rank · price · rating · rating_scale · review_count · offer_count · category · image_url · platform |
sellersRevisar un vendedor y el producto relacionado
| keyword | lang | Entrega síncrona | El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · name · business_name · phone · address · rating · rating_scale · review_count · product_asin · product_name · product_url · product_price · product_currency · product_brand · product_rating · platform |
¿Qué acepta cada acción de Amazon?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
¿Qué significan los parámetros de Amazon search?
Pasa el producto en keyword, el sitio en domain —por ejemplo amazon.co.uk— y, si procede, el idioma en lang. price, currency, rating_count, in_stock y rank deben leerse dentro de ese mercado; un idioma no cambia por sí solo el país.
keywordObligatorio- Varía según la acción. Para
search, es el término de búsqueda del producto. Parabestsellers, se prefiere la URL completa de la lista de los más vendidos de una categoría de Amazon, aunque también acepta el slug de la categoría para construir la ruta. Parasellers, puedes enviar la URL de una página de producto o vendedor; si es texto normal, construye primero una página de búsqueda de productos, no es una búsqueda precisa por ID de vendedor. domainOpcional- Dominio del sitio nacional de Amazon, como
amazon.com,amazon.co.ukoamazon.co.jp. No incluyashttps://ni la ruta de la página.searchlo usa para construir la página de búsqueda yreviewspara seleccionar el sitio de las reseñas. El valor por defecto esamazon.com. Para reseñas de productos no estadounidenses, debes seleccionar explícitamente el sitio que coincida con el enlace del producto. langOpcional- Idioma del contenido de la página. Usa
enpara inglés ojapara japonés. Para chino simplificado y tradicional, usazhcnyzhtwrespectivamente, no el genéricozh. Solo se aceptan los códigos de idioma listados en esta API. Elegir el idioma no equivale a cambiar el sitio del país.Valores permitidos:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw
¿Qué significan los parámetros de Amazon profile?
url debe contener el enlace del producto con su ASIN. Devuelve datos del artículo, marca, precio y disponibilidad pública; aquí profile no significa perfil de comprador o vendedor, e in_stock no es una cantidad reservada.
urlObligatorio- Enlace del producto de Amazon, como
https://www.amazon.com/dp/<ASIN>. La acciónreviewsextrae el ASIN (10 caracteres alfanuméricos en mayúsculas) de las rutas/dp/,/gp/product/o/product-reviews/. No se puede usar la página de inicio de la tienda en su lugar. En este contexto,profilese refiere a los detalles del producto, no a un perfil de usuario.Amazon: definición y localización del ASINAmazon define el ASIN como un identificador alfanumérico de diez caracteres y explica que suele aparecer tras `/dp/` en la URL del producto. Esta pista sirve para identificar el objeto solicitado, no para ampliar los campos disponibles.Consultada langOpcional- Idioma del contenido de la página. Usa
enpara inglés ojapara japonés. Para chino simplificado y tradicional, usazhcnyzhtwrespectivamente, no el genéricozh. Solo se aceptan los códigos de idioma listados en esta API. Elegir el idioma no equivale a cambiar el sitio del país.Valores permitidos:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw
¿Qué significan los parámetros de Amazon reviews?
Usa la url del producto y, fuera de Estados Unidos, un domain coherente con ese enlace. La respuesta distingue review_id, product_asin, valoración, variante y compra verificada; el contrato no publica un parámetro de ordenación de reseñas.
urlObligatorio- Enlace del producto de Amazon, como
https://www.amazon.com/dp/<ASIN>. La acciónreviewsextrae el ASIN (10 caracteres alfanuméricos en mayúsculas) de las rutas/dp/,/gp/product/o/product-reviews/. No se puede usar la página de inicio de la tienda en su lugar. En este contexto,profilese refiere a los detalles del producto, no a un perfil de usuario.Amazon: definición y localización del ASINAmazon define el ASIN como un identificador alfanumérico de diez caracteres y explica que suele aparecer tras `/dp/` en la URL del producto. Esta pista sirve para identificar el objeto solicitado, no para ampliar los campos disponibles.Consultada domainOpcional- Dominio del sitio nacional de Amazon, como
amazon.com,amazon.co.ukoamazon.co.jp. No incluyashttps://ni la ruta de la página.searchlo usa para construir la página de búsqueda yreviewspara seleccionar el sitio de las reseñas. El valor por defecto esamazon.com. Para reseñas de productos no estadounidenses, debes seleccionar explícitamente el sitio que coincida con el enlace del producto.
¿Qué significan los parámetros de Amazon bestsellers?
En keyword, prioriza la URL completa de la categoría de Best Sellers. rank es la posición observada dentro de esa lista, no una cifra de ventas; esta acción no sustituye la búsqueda general ni conserva el histórico.
keywordObligatorio- Varía según la acción. Para
search, es el término de búsqueda del producto. Parabestsellers, se prefiere la URL completa de la lista de los más vendidos de una categoría de Amazon, aunque también acepta el slug de la categoría para construir la ruta. Parasellers, puedes enviar la URL de una página de producto o vendedor; si es texto normal, construye primero una página de búsqueda de productos, no es una búsqueda precisa por ID de vendedor. langOpcional- Idioma del contenido de la página. Usa
enpara inglés ojapara japonés. Para chino simplificado y tradicional, usazhcnyzhtwrespectivamente, no el genéricozh. Solo se aceptan los códigos de idioma listados en esta API. Elegir el idioma no equivale a cambiar el sitio del país.Valores permitidos:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw
¿Qué significan los parámetros de Amazon sellers?
keyword puede recibir una página relacionada con un producto o vendedor. Contrasta business_name, product_asin, product_name y la URL; una búsqueda textual puede caer en resultados de productos y no garantiza un directorio completo ni una acreditación comercial.
keywordObligatorio- Varía según la acción. Para
search, es el término de búsqueda del producto. Parabestsellers, se prefiere la URL completa de la lista de los más vendidos de una categoría de Amazon, aunque también acepta el slug de la categoría para construir la ruta. Parasellers, puedes enviar la URL de una página de producto o vendedor; si es texto normal, construye primero una página de búsqueda de productos, no es una búsqueda precisa por ID de vendedor. langOpcional- Idioma del contenido de la página. Usa
enpara inglés ojapara japonés. Para chino simplificado y tradicional, usazhcnyzhtwrespectivamente, no el genéricozh. Solo se aceptan los códigos de idioma listados en esta API. Elegir el idioma no equivale a cambiar el sitio del país.Valores permitidos:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw
Cómo usar la API de Amazon
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"amazon","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Amazon
¿Cómo llamo a la API de Amazon?
Envía POST /api/v1/social con platform igual a amazon, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Amazon?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye asin, title, brand y price. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Amazon?
Amazon define el ASIN como un identificador alfanumérico de diez caracteres y explica que suele aparecer tras /dp/ en la URL del producto. Esta pista sirve para identificar el objeto solicitado, no para ampliar los campos disponibles.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; reviews requiere url; consulta las demás acciones en la lista de funciones.