Amazon Product Search
Amazon Product Search convierte una frase de producto y la URL de una tienda en registros públicos de productos normalizados. Cada elemento puede incluir una URL de origen, título, descripción, vendedor, precio, calificación, cantidad de reseñas, cantidad de unidades vendidas, contenido multimedia, momento de publicación y momento de recopilación cuando esos valores están disponibles.
Funcionalidades de la Amazon Product Search API
- Consultas acotadas a una tiendaCombine una consulta de producto no vacía con un dominio de Amazon compatible para que la tienda solicitada quede explícita.
- Volumen de resultados controladoDefina un results_limit entero de 1 a 2,000; el recolector se detiene al llegar al límite solicitado o cuando ya no hay más registros en la fuente.
- Identidad de producto normalizadaReciba campos de producto estables para ID, tipo, URL de origen, título, descripción, momento de publicación y momento de recopilación.
- Contexto comercialUse los campos disponibles de vendedor, precio, calificación, cantidad de reseñas, cantidad de unidades vendidas y contenido multimedia, sin tener que analizar la estructura de resultados propia de cada tienda.
Parámetros de la Amazon Product Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave o frase de producto obligatoria y no vacía. |
domain | Obligatorio | Referencia obligatoria a la tienda de Amazon. Su nombre de host analizado debe ser amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp o un subdominio. Se aceptan referencias con cualquier esquema que tenga un nombre de host y referencias relativas al protocolo. |
results_limit | Opcional | Límite de resultados solicitado, de 1 a 2,000. Su valor predeterminado es 100 si se omite. |
Cómo usar la Amazon Product Search API
Elija la tienda deseada y una frase de producto concreta, y luego envíe una sola solicitud asíncrona.
- Defina una query no vacía, indique la URL de un dominio de Amazon compatible y elija un results_limit de 1 a 2,000.
- Envíe la solicitud por POST a /v1/amazon/product-search y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- Tras el éxito, lea data.results.items y pase next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Amazon Product Search API
- Descubrimiento de productos en una tienda: Encuentre productos públicos que coincidan con una categoría, función, marca o frase de intención de compra en una tienda de Amazon compatible.
- Comparación de ofertas: Compare los importes, monedas, precios con formato e identidad del vendedor disponibles entre los productos devueltos.
- Evaluación preliminar de reputación: Revise las calificaciones, cantidades de reseñas y cantidades de unidades vendidas disponibles, y conserve las señales ausentes como no disponibles.
- Enriquecimiento de catálogo: Enriquezca los productos candidatos con títulos, descripciones, URL de origen, contenido multimedia, vendedores y marcas de tiempo de recopilación normalizados.
Consejos de expertos para la Amazon Product Search API
- Guarde la query y el domain enviados con cada tarea, porque la misma frase puede producir resultados distintos según la tienda.
- Elija results_limit según el volumen que necesite: determina la estimación de resultados reservada, mientras que la facturación final se liquida según los registros devueltos.
- Siga next_cursor hasta que has_more sea false cuando una tarea exitosa contenga más de una página de resultados almacenados.
- Trate los valores ausentes de vendedor, precio, calificación, cantidad de reseñas, cantidad de unidades vendidas o contenido multimedia como no disponibles, y no como cero ni como una identidad vacía.
APIs relacionadas
Además de la Amazon Product Search API, use estas APIs cuando necesite otro tipo de datos públicos de Amazon.
- Amazon Best Sellers API — Recolecta productos desde URLs públicas de categorías de más vendidos de Amazon, con campos normalizados de vendedor, precio, reputación, cantidad vendida, contenido multimedia, origen y marca de tiempo.
- Amazon Product Details API — Recolecta detalles de productos desde URLs conocidas de Amazon, con campos de título, descripción, vendedor, precio, calificación, cantidad de reseñas, cantidad vendida y contenido multimedia.
- Amazon Reviews API — Recolecta reseñas públicas de productos desde URLs de Amazon compatibles, con texto, calificaciones, datos del autor, referencias al producto, marcas de tiempo y contenido multimedia.
- Amazon Seller Info API — Recolecta desde URLs conocidas de vendedores la identidad pública del perfil de vendedor de Amazon, descripción, sitio web, calificación, comentarios, ubicación, origen y campos de hora de recolección.
- Amazon Storefront API — Lee la tienda de un creador de Amazon a partir de su URL con perfil, cuentas sociales vinculadas, listas de ideas con número de artículos, posts curados y productos en tendencia con precio.