API de búsqueda de Amazon para vendedores

Busca productos de Amazon con datos estructurados

El Amazon Search API permite buscar productos por palabra clave o por una lista exacta de ASIN. La respuesta puede incluir datos de producto, precio, ventas estimadas, valoración, número de reseñas y elementos del listing, según los campos que devuelva el contrato vigente.

Endpoint y autenticación

• Método: POST
• Endpoint canónico: https://ecommercedataapi.com/v1/amazon/product/competitor-lookup
• API code: amazon.products.search
• Coste documentado: 1 unidad de facturación por llamada correcta

Envía la clave en el encabezado X-API-Key. No la expongas en código del navegador, repositorios ni logs.

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "keyword": "wireless charger",
    "match_type": "broad",
    "include_variations": false,
    "page": 1,
    "size": 20
  }'

La solicitud usa marketplace, keyword o asins, match_type, include_variations, page y size según el caso. La documentación indica que se debe proporcionar exactamente una de keyword o asins.

Flujo recomendado

Define primero el marketplace, la consulta y el tamaño de página. Después compara los resultados con el producto, la categoría y el rango de precio que realmente estás evaluando. Los resultados sirven como evidencia de investigación, no como una garantía de ventas o de posición orgánica.

Límites

Los datos pueden estar retrasados, incompletos o variar por marketplace. Comprueba request_id y el objeto error cuando la respuesta no sea 2xx, y trata los límites 429 según la guía general de errores. Para más detalles, consulta la documentación existente de Product Search antes de integrar el endpoint.