Cómo obtener precios, stock y promociones de HEB México con una API

Para obtener precios de HEB México con una API, envía un POST a https://api.scavio.dev/api/v1/heb/search con {"query": "leche", "country": "mx"}. La respuesta trae 20 productos de heb.com.mx, cada uno con precio en pesos, precio regular cuando está rebajado, unidades en stock, marca, código de barras EAN y las promociones activas. Cuesta 2 créditos por página. HEB no ofrece una API pública, así que esta es la forma más directa de tener esos datos en JSON sin mantener un scraper.

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

Lo que necesitas

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

Paso 1: busca productos en HEB México

La única diferencia con HEB en Estados Unidos es "country": "mx":

curl -X POST 'https://api.scavio.dev/api/v1/heb/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"query": "leche", "country": "mx"}'

Esta es una de las 20 filas que devolvió esa búsqueda, recortada a los campos principales y sin alterar ningún valor:

{
  "id": "830848",
  "name": "Alpura Leche Deslactosada 4 Pack 4 L",
  "brand": "ALPURA",
  "url": "https://www.heb.com.mx/alpura-leche-deslactosada-4-pack-4-l-830848/p",
  "price": 10000,
  "list_price": 14200,
  "is_on_sale": true,
  "size": "4 l",
  "upc": "7501056215538",
  "in_stock": true,
  "stock": 156,
  "store_id": "hebmx002959",
  "category": "Leche",
  "is_sponsored": false,
  "promotions": [
    {
      "id": "price-based-rebajado",
      "type": "Rebajado",
      "label": "Rebajado",
      "description": "Precio rebajado",
      "discount": 29.58,
      "discount_type": "percent",
      "ends_at": null
    }
  ]
}

Los campos que más se usan:

La respuesta también trae total_results y total_pages. Para "leche" fueron 758 resultados en 38 páginas, y para "coca cola" 188 en 10. Avanza con "page": 2, "page": 3, y así hasta total_pages.

Paso 2: encuentra las rebajas

Los precios vienen en centavos y el precio regular solo aparece cuando hay rebaja, así que calcular el descuento es una resta:

import requests

resp = requests.post(
    "https://api.scavio.dev/api/v1/heb/search",
    headers={"Authorization": "Bearer sk_live_your_key"},
    json={"query": "leche", "country": "mx"},
    timeout=60,
)
for p in resp.json()["data"]["products"]:
    if p["is_on_sale"]:
        off = round((1 - p["price"] / p["list_price"]) * 100, 1)
        print(f'{p["name"]}: ${p["list_price"] / 100:.2f} -> ${p["price"] / 100:.2f} (-{off}%), {p["stock"]} en stock')

Con la búsqueda del 2 de noviembre, 13 de los 20 productos de la primera página estaban rebajados. Algunos de ellos:

Paso 3: lee las promociones

No todas las promociones bajan el precio. HEB México maneja tres tipos, y cada uno llega con su descripción y su fecha de fin en ends_at:

• Rebajado: precio rebajado. discount es el porcentaje y list_price trae el precio anterior.
• AhorraMas: multicompra, como "2x45" en Pepsi Black de 1.5 L, vigente hasta el 26 de noviembre de 2026. El precio unitario no cambia; el ahorro llega al comprar varias piezas.
• ComboLoco: producto de regalo. Al comprar detergente líquido HEB de 7 L, HEB regalaba un limpiador Windex de 640 ml, hasta el 12 de noviembre de 2026.

En la primera página de "detergente" había 4 productos con Rebajado (el Ariel Revitacolor de 4.8 L bajó de $246.00 a $179.00), 5 con ComboLoco y 2 con AhorraMas. Si solo miras el precio, te pierdes 7 de esas 11 promociones.

Paso 4: abre la ficha de producto

Para imágenes, ingredientes y tabla nutrimental, pasa la url de un resultado al endpoint de producto:

curl -X POST 'https://api.scavio.dev/api/v1/heb/product' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -d '{"country": "mx", "product_url": "https://www.heb.com.mx/alpura-leche-deslactosada-4-pack-4-l-830848/p"}'

Para esa leche, la respuesta trajo los ingredientes ("Leche parcialmente descremada, lactasa, vitaminas A y D...") y la tabla nutrimental por porción de 240 ml: 115 kcal, 7.5 g de proteína, 4.3 g de grasas totales y 120 mg de sodio. Los nombres de los nutrimentos vienen en español, tal como los publica HEB. También cuesta 2 créditos.

Paso 5: monitorea en el tiempo

Cada llamada lee HEB México en vivo, así que para seguir precios basta con guardar las respuestas de forma programada y comparar. El stock cambia rápido: el mismo Alpura 4 Pack marcó 156 unidades en la búsqueda y 131 en la ficha de producto minutos después. Si vas a alertar sobre quiebres de stock, compara contra la lectura más reciente, no contra una de hace horas.

Límites que conviene conocer

• Los precios y el stock son de la tienda predeterminada de HEB México (store_id en la respuesta). Elegir otra tienda de HEB México todavía no está disponible; la selección por tienda funciona solo para HEB en Estados Unidos.
• La búsqueda devuelve 20 productos por página. En búsquedas muy amplias el total se reporta como 1,000 ("café" devolvió 1,000 resultados en 50 páginas); para recorrer una categoría completa, divide en búsquedas más específicas.
• El contenido neto (size) y la tabla nutrimental solo aparecen cuando HEB los publica en el producto.

Cuánto cuesta

Búsqueda y producto cuestan 2 créditos cada uno. En el plan Growth con pago anual (US$2 por 1,000 créditos), una página de 20 productos cuesta US$0.004: revisar 1,000 productos sale en unos US$0.20. Los 50 créditos gratis del registro alcanzan para 25 llamadas.

La página de la API de HEB México tiene una prueba en vivo sin registro, y la documentación de búsqueda describe cada campo. Si también trabajas con HEB en Estados Unidos, con precios por tienda y localizador de sucursales, la página en inglés cubre esa parte. Para comparar con otras cadenas en México, la misma key funciona con la API de Walmart, incluido Walmart México, y con la API de Mercado Libre.