Cómo obtener precios, ofertas y vendedores de Amazon México con una API

Para obtener precios de Amazon México con una API, envía un POST a https://api.scavio.dev/api/v1/amazon/search de Scavio con {"query": "freidora de aire", "country": "mx", "language": "ES"}. La respuesta trae los productos de amazon.com.mx con ASIN, precio en pesos, calificación, número de opiniones y entrega. Con el ASIN, /product devuelve la ficha completa y /offers lista a cada vendedor y quién tiene el buy box. Cada llamada cuesta 1 crédito y no necesitas cuenta de Afiliados ni de vendedor.

Amazon no ofrece una API abierta para esto. La Product Advertising API 5.0 está obsoleta y su sucesora, la Creators API, pide estar inscrito en Amazon Afiliados y tener ventas recientes. La Selling Partner API es para administrar tu propio catálogo, no para leer el de otros.

Esta guía usa respuestas reales de amazon.com.mx capturadas el 2 de noviembre de 2026.

Lo que necesitas

• Una API key de Scavio. Al registrarte recibes 50 créditos gratis, sin tarjeta.
• Cualquier lenguaje que haga peticiones HTTP. Los ejemplos usan cURL y Python.

Paso 1: busca productos en Amazon México

country: "mx" elige amazon.com.mx y language: "ES" pide los textos en español:

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"query": "freidora de aire", "country": "mx", "language": "ES"}'

La búsqueda devolvió 48 productos en 1.6 segundos. Este es el encabezado de la respuesta y uno de los productos, sin url ni image para que quepa y sin alterar ningún valor:

{
  "query": "freidora de aire",
  "page": 1,
  "total_results_text": "1 a 48 de más de 10,000 resultados para freidora de aire",
  "count": 48,
  "products": [
    {
      "asin": "B0DKXY1RMP",
      "title": "Oster Freidora de Aire Digital, 4L, 10 Programas Automáticos, DiamondForce",
      "price": 999,
      "currency": "MXN",
      "rating": 4.7,
      "reviews_count": 676,
      "is_sponsored": false,
      "position": 4,
      "badge": "Opción Amazon",
      "sales_volume": "2 k+ comprados el mes pasado",
      "delivery": {
        "is_free": true,
        "date": "mañana, 3 de nov",
        "fastest_date": null
      }
    }
  ]
}

La respuesta también trae filters, con los mismos filtros de la página de Amazon (17 grupos para esta búsqueda, de "Marcas" a "Capacidad"), y total_results_text, la frase con el tamaño de la búsqueda. Para la página siguiente, manda "page": 2.

Paso 2: abre la ficha por ASIN

Para la Ninja Foodi DualZone, el resultado con más opiniones de esa búsqueda:

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"query": "B089TQWJKK", "country": "mx", "language": "ES"}'

La respuesta, recortada a los campos de precio y vendedor:

{
  "asin": "B089TQWJKK",
  "title": "Ninja Foodi Freidora de Aire DualZone 8QT 6 en 1 Gris DZ201",
  "brand": "Ninja",
  "price": 3054,
  "list_price": 4699,
  "currency": "MXN",
  "rating": 4.8,
  "reviews_count": 24083,
  "is_prime": true,
  "has_buy_box": true,
  "availability": "Disponible",
  "max_quantity": 30,
  "sold_by": "Amazon México",
  "other_sellers_count": 5,
  "sales_volume": "900+ comprados el mes pasado",
  "best_sellers_rank": [
    { "category": "Hogar y Cocina", "rank": 614 },
    { "category": "Freidoras de aire", "rank": 6 }
  ]
}

La ficha completa también trae 5 viñetas en features, 14 imágenes, un video, 38 especificaciones con las etiquetas de Amazon en español ("Capacidad", "Ajuste de temperatura máxima"), las variantes y las opciones de envío. Tres cosas que conviene saber:

• reviews_count aquí es el número exacto (24,083). En la búsqueda la misma freidora decía 24000, porque Amazon redondea ese dato en los resultados. No compares uno con otro.
• availability es el texto de Amazon ("Disponible"), no un booleano.
• other_sellers_count te dice si vale la pena pagar el paso 3: con 5, sí.

Paso 3: ve a todos los vendedores y el buy box

curl -X POST 'https://api.scavio.dev/api/v1/amazon/offers' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"asin": "B089TQWJKK", "country": "mx", "language": "ES"}'

La respuesta trajo 5 ofertas con has_more_pages: false, o sea la lista completa. Esta es una de ellas, recortada sin cambiar valores:

{
  "condition": "Nuevo",
  "seller_id": "A2T6JI58AY89DO",
  "seller_name": "GLOBAL TAN LLC",
  "ships_from": "GLOBAL TAN LLC",
  "is_fulfilled_by_amazon": false,
  "is_buy_box_winner": false,
  "price": 4162.03,
  "currency": "MXN",
  "list_price": 4699,
  "shipping_price": 0,
  "discount_percentage": 11.43,
  "promotion": "Ahorra 5 % en cualquier 2",
  "quantity": 3,
  "delivery": {
    "min_hours": 24,
    "max_hours": 72,
    "date": "entre el 9 - 10 de noviembre",
    "is_free": false
  }
}

Y las 5 juntas:

Amazon México tenía el buy box con el precio nuevo más bajo, pero la misma freidora nueva llegaba a costar $6,883.06 con envío con otro vendedor, 125% más. Si tu producto vende la Ninja y compites contra esa lista, la ficha sola no te lo dice.

Paso 4: calcula el costo con envío y vigílalo

price no incluye el envío; shipping_price viene aparte. Para comparar ofertas, súmalos:

import requests

resp = requests.post(
    "https://api.scavio.dev/api/v1/amazon/offers",
    headers={"Authorization": "Bearer sk_live_your_key"},
    json={"asin": "B089TQWJKK", "country": "mx", "language": "ES"},
    timeout=60,
)
data = resp.json()["data"]
for o in sorted(data["offers"], key=lambda o: o["price"] + (o["shipping_price"] or 0)):
    total = o["price"] + (o["shipping_price"] or 0)
    marca = " <- buy box" if o["is_buy_box_winner"] else ""
    print(f'{o["seller_name"]:28} {o["condition"]:26} ${total:,.2f}{marca}')
if data["has_more_pages"]:
    print("solo la primera página de ofertas")

Con la respuesta del 2 de noviembre imprime:

Cada llamada lee Amazon México en ese momento, así que para tener historial basta con correr esto de forma programada (cada hora, cada día) y guardar lo que devuelve. Una alerta útil: avisar cuando is_buy_box_winner cambia de vendedor o cuando el precio del buy box baja de cierto monto.

Paso 5: confirma el código de país

GET https://api.scavio.dev/api/v1/amazon/options es gratis y no pide API key. Devuelve los 22 marketplaces; México es {"value": "mx", "label": "Mexico"} y su dominio com.mx. Vale la pena validar contra esa lista: un código de dos letras que no existe no da error, regresa resultados de amazon.com (Estados Unidos).

Límites que conviene conocer

• No hay orden del lado del servidor. Amazon ignora el orden que se le pide, así que la API no lo ofrece; ordena tú la página por price.
• position es la casilla de Amazon contando anuncios, no el índice del arreglo. En otra llamada a la misma búsqueda ese día, 12 de 60 resultados eran patrocinados y 10 de ellos repetían un ASIN que también salía orgánico; si cuentas productos, elimina duplicados por asin.
• badge a veces trae un texto cortado de Amazon, como "Termina en" en ofertas por tiempo limitado. Úsalo como texto, no como categoría.
• description puede traer solo un texto de la página: en la Ninja DualZone fue "Más información del producto". Las viñetas de features y las specifications sí traen el contenido.
• /offers devuelve la primera página. Si has_more_pages es true, hay más vendedores de los que viste.
• reviews en la ficha son metadatos (autor, fecha, compra verificada), sin el texto de la opinión.

Todos los endpoints de Amazon para México

Cuánto cuesta

En el plan Growth con pago anual (US$0.001995 por crédito) son unos US$2 por 1,000 llamadas. Revisar 200 ASIN cada día con ficha y ofertas son 400 créditos diarios, unos 12,000 al mes: US$24 a esa tarifa. Los 50 créditos del registro alcanzan para 50 llamadas, y los planes empiezan en US$30 al mes por 7,000 créditos (precios).

Para empezar

1. Prueba la API de Amazon gratis: 50 créditos, sin tarjeta.
2. Prueba una búsqueda en vivo en la página de la API de Amazon, sin registro.
3. Lee los parámetros en la documentación de búsqueda, producto, ofertas y marketplaces.

Si comparas Amazon España, la misma key funciona con "country": "es"; en las mejores APIs de datos de Amazon España contamos cuántas ofertas hay detrás de 12 auriculares de amazon.es. Para otras tiendas de México, la misma key cubre la API de Mercado Libre, la API de Walmart y HEB México.