API de Cheve.com

Cheve.com está diseñada como una fuente de datos estructurada. La API interna ya expone los precios en JSON y, más adelante, se abrirá a partners y asistentes de IA (incluida documentación MCP/WebMCP).

Endpoints

Método	Ruta	Descripción
GET	/api/products?brand=&type=&q=&limit=	Catálogo de productos.
GET	/api/products/{slug\|gtin}?city=	Producto + ofertas por ciudad.
GET	/api/prices?city=&retailer=&product=&limit=	Precios registrados.
GET	/api/prices/best?product=&city=	Mejor precio (formato para agentes).
GET	/api/history/{slug}?days=90&city=	Serie histórica diaria.
GET	/api/retailers	Retailers y estado de ingesta.
GET	/api/cities	Ciudades cubiertas.

Ejemplo

Pregunta: ¿Dónde está más barata la Modelo Especial 12-pack en Monterrey?

GET https://cheve-com.vercel.app/api/prices/best?product=modelo-especial-12-pack-355ml&city=monterrey

{
  "data": {
    "product": "Modelo Especial",
    "presentation": "12 x 355 ml",
    "city": "Monterrey",
    "best_price": 212,
    "currency": "MXN",
    "retailer": "HEB",
    "price_per_liter": 49.77,
    "captured_at": "..."
  }
}

Respuestas con Cache-Control de 5 minutos y CORS abierto. El uso está sujeto a los Términos. Para acceso de alto volumen o feeds, escribe a datos@cheve.com.