HEB México

API de búsqueda de HEB México

Busca productos de HEB México (heb.com.mx) por palabra clave con "country": "mx" y recibe 20 resultados por página en JSON: precio en centavos de peso, precio regular cuando hay rebaja, marca, código de barras EAN, categoría, unidades en stock, promociones y marca de patrocinado, con el total real de resultados y de páginas. Sin country, la misma ruta consulta HEB en Estados Unidos. Cuesta 2 créditos por solicitud.

POST/api/v1/heb/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Palabras a buscar, de 1 a 200 caracteres.

Example: leche

countrystringdefault:us

"mx" para HEB México (heb.com.mx), con precios en centavos de peso, stock y promociones por resultado. "us" (predeterminado) para heb.com.

Example: mx

pageintegerdefault:1

Página de resultados, empezando en 1 (1-100). En México cada página trae 20 productos.

Example: 2

page_sizeintegerdefault:60

Resultados por página, 1-60. Solo Estados Unidos; en México las páginas siempre traen 20.

Example: 10

store_idstring | integer

Número de tienda HEB de /api/v1/heb/stores. Solo Estados Unidos: no se admite con "mx".

Example: 441

Request

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
results = client.heb.search("leche", country="mx")

data = results["data"]
print(data["total_results"], "resultados en", data["total_pages"], "páginas")
for item in data["products"]:
    # price viene en centavos de peso: 10000 = $100.00 MXN
    print(item["name"], item["price"], item["list_price"], item["stock"])

Response

"query": "leche",

"page": 1,

"country": "mx",

"count": 20,

"total_results": 758,

"total_pages": 38,

"store_id": "hebmx002959",

"response_time": 5287,

"fetched_at": "2026-11-02T11:00:03.688Z",

"credits_used": 2,

"credits_remaining": 74526

}

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 results = client.heb.search("leche", country="mx") data = results["data"] print(data["total_results"], "resultados en", data["total_pages"], "páginas") for item in data["products"]: # price viene en centavos de peso: 10000 = $100.00 MXN print(item["name"], item["price"], item["list_price"], item["stock"])