API de HEB México
Datos de supermercado de heb.com.mx en JSON estructurado: busca cualquier producto y recibe precio en pesos, precio regular cuando hay rebaja, unidades en stock, marca, código de barras y promociones, y abre la ficha con imágenes, ingredientes y tabla nutrimental. Cada consulta es un solo POST.
50 créditos gratis al registrarte, suficientes para 25 búsquedas en HEB México. Sin tarjeta.
{ "data": { "query": "leche", "page": 1, "country": "mx", "count": 20, "total_results": 758, "total_pages": 38, "store_id": "hebmx002959", "products": [ { "id": "830848", "name": "Alpura Leche Deslactosada 4 Pack 4 L", "brand": "ALPURA", "is_own_brand": null, "url": "https://www.heb.com.mx/alpura-leche-deslactosada-4-pack-4-l-830848/p", "image": "https://heb-prod.styrk.io/loolu/cdn/ecommerce/img/1/322191/322191_01.webp?v=8f5d0a7a", "price": 10000, "list_price": 14200, "is_on_sale": true, "unit_price": null, "size": "4 l", "upc": "7501056215538", "in_stock": true, "stock": 156, "store_id": "hebmx002959", "availability": [], "is_ebt_snap": null, "category": "Leche", "category_id": null, "product_location": null, "is_sponsored": false, "promotions": [ { "id": "price-based-rebajado", "type": "Rebajado", "label": "Rebajado", "description": "Precio rebajado", "discount": 29.58, "discount_type": "percent", "ends_at": null } ] }, { "id": "561471", "name": "HCF Leche Entera 1 L", "brand": "HCF", "is_own_brand": null, "url": "https://www.heb.com.mx/hcf-leche-entera-1-l-561471/p", "image": "https://heb-prod.styrk.io/loolu/cdn/ecommerce/img/1/310838/310838_01.webp?v=3197ee5c", "price": 2600, "list_price": null, "is_on_sale": false, "unit_price": null, "size": "1 l", "upc": "0041220018222", "in_stock": true, "stock": 1722, "store_id": "hebmx002959", "availability": [], "is_ebt_snap": null, "category": "Leche", "category_id": null, "product_location": null, "is_sponsored": false, "promotions": [] } ] }, "response_time": 5287}Llamada en vivo al endpoint real en HEB México. 2 ejecuciones gratis; después, con tu propia key.
¿Qué es la API de HEB México de Scavio?
La API de HEB México de Scavio es una API REST que devuelve datos públicos de heb.com.mx en JSON estructurado. HEB no tiene una API pública; los 2 endpoints POST de Scavio cubren búsqueda de productos con precio en pesos, stock, código de barras y promociones, y la ficha de producto con imágenes, ingredientes y tabla nutrimental, a 2 créditos por llamada y con una sola API key.
- 2
- endpoints para HEB México, en producción
- 20
- productos por página, con total de resultados
- 2
- créditos por llamada
Los datos de HEB México que sí necesitas
Precio, stock y promociones de cada producto, no solo nombres e imágenes.
Búsqueda con precio y stock
POST /api/v1/heb/searchBusca cualquier producto en heb.com.mx y recibe 20 resultados por página, cada uno con su precio en pesos, las unidades en stock, la marca, el código de barras EAN y la categoría. La respuesta trae el total real: 758 resultados en 38 páginas para "leche".
Rebajas y promociones
POST /api/v1/heb/searchCada resultado trae las promociones de HEB con su fecha de fin: precio rebajado (Rebajado), multicompra como 2x45 (AhorraMas) y producto de regalo (ComboLoco). Cuando hay rebaja, list_price trae el precio regular para medir el descuento.
Ficha de producto con tabla nutrimental
POST /api/v1/heb/productAbre un producto con la URL que devuelve la búsqueda: precio, stock, todas las imágenes, descripción en texto plano, contenido neto, ingredientes y la tabla nutrimental por porción, tal como la publica HEB.
Los 2 endpoints de la API de HEB México
Ambas rutas son POST, devuelven JSON y usan la misma API key. Agrega "country": "mx" al cuerpo. 2 créditos por llamada exitosa.
| Endpoint | Devuelve | Créditos |
|---|---|---|
Búsqueda/api/v1/heb/search | 20 productos por página por palabra clave, con precio en pesos, precio regular cuando hay rebaja, marca, código de barras EAN, categoría, unidades en stock, promociones y marca de patrocinado; total real de resultados y de páginas | 2 |
Producto/api/v1/heb/product | Un producto por URL: precio, precio regular, stock, promociones, todas las imágenes, descripción, contenido neto, ingredientes y tabla nutrimental cuando HEB la publica | 2 |
Los 50 créditos gratis del registro alcanzan para 25 llamadas. El localizador de tiendas y los precios por tienda (store_id) son solo para HEB en Estados Unidos. Ver planes
Busca en HEB México desde tu código
Una búsqueda de "leche" devuelve precio, precio regular, stock, marca, código de barras y promociones por producto. La respuesta de la derecha es una captura real, con sus nombres de campo.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Búsqueda en HEB México - 2 créditos, 20 productos por página
res = client.heb.search("leche", country="mx")
for p in res["data"]["products"]:
# price viene en centavos: 10000 = $100.00 MXN
print(p["name"], p["price"] / 100, p["stock"], p["is_on_sale"])
# Ficha de producto con la URL de la búsqueda - 2 créditos
url = res["data"]["products"][0]["url"]
detail = client.heb.product(product_url=url, country="mx")
print(detail["data"]["ingredients"], detail["data"]["nutrition"]){
"data": {
"query": "leche",
"page": 1,
"country": "mx",
"count": 20,
"total_results": 758,
"total_pages": 38,
"store_id": "hebmx002959",
"products": [
{
"id": "830848",
"name": "Alpura Leche Deslactosada 4 Pack 4 L",
"brand": "ALPURA",
"is_own_brand": null,
"url": "https://www.heb.com.mx/alpura-leche-deslactosada-4-pack-4-l-830848/p",
"image": "https://heb-prod.styrk.io/loolu/cdn/ecommerce/img/1/322191/322191_01.webp?v=8f5d0a7a",
"price": 10000,
"list_price": 14200,
"is_on_sale": true,
"unit_price": null,
"size": "4 l",
"upc": "7501056215538",
"in_stock": true,
"stock": 156,
"store_id": "hebmx002959",
"availability": [],
"is_ebt_snap": null,
"category": "Leche",
"category_id": null,
"product_location": null,
"is_sponsored": false,
"promotions": [
{
"id": "price-based-rebajado",
"type": "Rebajado",
"label": "Rebajado",
"description": "Precio rebajado",
"discount": 29.58,
"discount_type": "percent",
"ends_at": null
}
]
},
{
"id": "561471",
"name": "HCF Leche Entera 1 L",
"brand": "HCF",
"is_own_brand": null,
"url": "https://www.heb.com.mx/hcf-leche-entera-1-l-561471/p",
"image": "https://heb-prod.styrk.io/loolu/cdn/ecommerce/img/1/310838/310838_01.webp?v=3197ee5c",
"price": 2600,
"list_price": null,
"is_on_sale": false,
"unit_price": null,
"size": "1 l",
"upc": "0041220018222",
"in_stock": true,
"stock": 1722,
"store_id": "hebmx002959",
"availability": [],
"is_ebt_snap": null,
"category": "Leche",
"category_id": null,
"product_location": null,
"is_sponsored": false,
"promotions": []
}
]
},
"response_time": 5287
}¿Por qué no hacer tu propio scraper de HEB México?
HEB no ofrece una API pública, y mantener tu propia integración significa perseguir un sitio que cambia.
Scraper propio de heb.com.mx
- HEB no ofrece una API pública para productos, precios o inventario
- El sitio cambia y hay que mantener el parser, los bloqueos y los reintentos
- Precios, stock y promociones hay que unirlos a cada producto sin confundirlos
- Cada formato de promoción (rebaja, 2x, regalo) se muestra distinto
API de HEB México de Scavio
- Dos endpoints POST con JSON limpio y los mismos nombres de campo que HEB Estados Unidos
- Precio, precio regular, stock, código de barras y promociones en cada resultado
- Total real de resultados y páginas para recorrer una categoría completa
- Una key, 50 créditos gratis al registrarte y el mismo formato que Walmart y Costco
Scavio devuelve solo datos públicos.
Lo que construyen los desarrolladores
Monitoreo de precios de supermercado
Sigue el precio de los productos que te importan en HEB México de forma programada y detecta cada rebaja: cuando list_price supera a price, el producto está rebajado y el descuento sale de la diferencia. El 2 de noviembre de 2026, el Ariel Revitacolor de 4.8 L costaba $179.00 contra $246.00 de precio regular.
searchDisponibilidad y quiebres de stock
Cada resultado trae las unidades en stock, no solo un sí o no. Úsalo para detectar productos agotados o con pocas piezas antes que tu competencia. Es una cifra en vivo: el Alpura Deslactosada 4 Pack pasó de 156 a 131 unidades entre dos llamadas hechas con minutos de diferencia.
search + productSeguimiento de promociones
Lista las promociones activas por categoría con su tipo y fecha de fin: rebajas, 2x45 y regalos. Ideal para marcas que miden la actividad promocional en anaquel o para apps de ahorro.
searchComparación entre cadenas
Compara HEB México con Walmart México y Costco México con la misma API key y un formato JSON parecido, y con Mercado Libre para el canal en línea.
search + APIs de Walmart, Costco y Mercado LibreCatálogo con código de barras
El código EAN de cada producto permite cruzar HEB con tu propio catálogo o con otras cadenas sin depender del nombre, que cambia entre tiendas.
search + productAgentes de IA para compras
Dale a un agente la búsqueda de HEB México para responder qué leche deslactosada está en rebaja hoy o cuánto cuesta un producto, con datos en vivo.
REST + servidor MCPCómo obtener datos de HEB México en JSON
- 1
Obtén una API key
Crea una cuenta de Scavio y copia tu key desde el dashboard. Recibes 50 créditos gratis al registrarte, sin tarjeta y sin cuenta de HEB.
- 2
Busca en HEB México
Envía {"query": "leche", "country": "mx"} a https://api.scavio.dev/api/v1/heb/search con un header Authorization: Bearer. Cada resultado trae precio, stock, marca, código de barras y promociones; usa page para avanzar de 20 en 20.
- 3
Abre la ficha de producto
Pasa la url de un resultado a /api/v1/heb/product junto con "country": "mx" para obtener todas las imágenes, la descripción, los ingredientes y la tabla nutrimental.
Preguntas frecuentes sobre la API de HEB México
¿HEB México tiene una API pública?
+
No. HEB no ofrece una API pública para consultar productos, precios o inventario de heb.com.mx. La API de HEB México de Scavio llena ese hueco con dos endpoints POST que devuelven JSON estructurado: búsqueda por palabra clave y ficha de producto, a 2 créditos por llamada.
¿Qué datos devuelve la búsqueda?
+
20 productos por página, cada uno con id, nombre, marca, URL, imagen, precio, precio regular cuando hay rebaja, código de barras EAN, contenido neto cuando HEB lo publica, categoría, unidades en stock, marca de patrocinado y promociones. La respuesta también trae total_results y total_pages: el 2 de noviembre de 2026, "leche" devolvió 758 resultados en 38 páginas y "coca cola" 188 en 10.
¿En qué formato vienen los precios?
+
En centavos de peso mexicano, como números enteros: 10000 es $100.00 MXN. Así no hay errores de redondeo al comparar. Cuando un producto está rebajado, is_on_sale es true y list_price trae el precio regular; si no, list_price es null.
¿Puedo saber cuántas piezas hay en stock?
+
Sí. El campo stock trae las unidades disponibles que HEB México muestra para cada producto, y in_stock es true cuando son más de cero. Es una cifra en vivo que cambia durante el día: el Alpura Leche Deslactosada 4 Pack marcó 156 unidades en una búsqueda y 131 en la ficha de producto minutos después.
¿Qué promociones devuelve?
+
Las que HEB México muestra en cada producto, con id, tipo, etiqueta, descripción, descuento y fecha de fin. Los tipos que vimos son Rebajado (precio rebajado, con el porcentaje de descuento), AhorraMas (multicompra, como "2x45" en Pepsi Black de 1.5 L, vigente hasta el 26 de noviembre de 2026) y ComboLoco (producto de regalo, como un limpiador Windex al comprar detergente HEB de 7 L).
¿Los precios son de una tienda específica?
+
Los precios y el stock son los de la tienda predeterminada de HEB México, y cada respuesta incluye su identificador en store_id. Elegir otra tienda de HEB México todavía no está disponible; la selección de tienda con store_id funciona solo para HEB en Estados Unidos.
¿Qué incluye la ficha de producto?
+
Todo lo de la búsqueda más todas las imágenes, la descripción en texto plano, los ingredientes y la tabla nutrimental cuando HEB la publica, por porción (con el tamaño de porción) o por 100 g. Los nombres de los nutrimentos vienen en español, tal como aparecen en HEB. Para la leche Alpura Deslactosada, la porción de 240 ml marca 115 kcal y 7.5 g de proteína.
¿Cómo obtengo la URL de un producto?
+
Del campo url de cada resultado de búsqueda, por ejemplo https://www.heb.com.mx/alpura-leche-deslactosada-4-pack-4-l-830848/p. También puedes pasar cualquier URL de producto de heb.com.mx que copies del navegador. El número al final de la URL es el id del producto.
¿Cuánto cuesta la API de HEB México?
+
Búsqueda y producto cuestan 2 créditos por llamada. En el plan Growth con pago anual (US$2 por 1,000 créditos) son US$0.004 por página de 20 productos, unos US$0.20 por 1,000 productos. Las cuentas nuevas reciben 50 créditos gratis sin tarjeta, y los planes pagos empiezan en US$30 al mes por 7,000 créditos. Las fallas temporales no se cobran.
¿Qué tan actualizados están los datos?
+
Cada solicitud lee HEB México en vivo en el momento de la llamada, así que cambios de precio, rebajas nuevas y movimientos de stock aparecen en cuanto HEB los muestra. Nada sale de una copia en caché. Para ver la evolución de un precio, guarda las respuestas de forma programada y compáralas.
¿También cubre HEB en Estados Unidos?
+
Sí, con la misma key. Sin country, o con "country": "us", la API consulta heb.com e incluye precios por tienda con store_id, elegibilidad SNAP/EBT, ubicación en pasillo y un localizador de tiendas. La página en inglés describe esa parte.
¿Es legal usar datos de HEB México?
+
Scavio devuelve datos públicos: lo que cualquiera ve en heb.com.mx sin iniciar sesión, como productos, precios, stock y promociones. No accede a cuentas ni a historial de compras. Si tu uso específico está permitido depende de tu jurisdicción, tu caso de uso y los términos de HEB, y tú eres responsable de cómo usas los datos. Esto no es asesoría legal; consulta a tu propio abogado.
Más de Scavio
HEB API (English)
HEB US and Mexico in English, with store-level pricing and the store locator.
API de Mercado Libre
Publicaciones, precios, opiniones y más vendidos en México, Argentina, Colombia y Brasil.
API de Walmart
Búsqueda, producto, opiniones y vendedores, incluido Walmart México.
API de Costco
Búsqueda en Costco México y precios por almacén en Estados Unidos y Canadá.
Documentación de la API
Búsqueda y producto con parámetros y respuestas reales de México.
Precios
Paquetes de créditos y planes, sin recargo por plataforma.
Empieza a obtener datos de HEB México hoy
50 créditos gratis al registrarte, sin tarjeta. Tu primera solicitud es un POST con un producto y "country": "mx".