Quickstart

La key demo es pública: sirve datos reales, con un alcance acotado (ver Autenticación y límites). Úsala para evaluar; para integrar, pide una key nominal.

export PANGUI_KEY=pk_demo_BxJI6vZ18OaXVmK0ZrBQJsRi_FG_u8ib

Ofertas vigentes de un emisor

curl -s "https://api.panguiapp.com/beta/offers?issuer=banco-de-chile&limit=3" \
  -H "Authorization: Bearer $PANGUI_KEY"

{
  "data": [
    {
      "id": "off_…",
      "status": "active",
      "title": "30% de descuento en …",
      "benefit": { "kind": "percentage", "value": 30, "currency": null,
                   "cap": { "value": 15000, "currency": "CLP" }, "summary": "30% dcto, tope $15.000" },
      "issuer": { "id": "iss_banco-de-chile", "slug": "banco-de-chile", "name": "Banco de Chile",
                  "type": "bank", "country": "CL" },
      "valid_from": "2026-09-01",
      "valid_until": "2026-12-31",
      "…": "…"
    }
  ],
  "meta": { "data_as_of": "2026-09-27T08:12:00.000Z", "schema_version": "beta.1",
            "count": 3, "total": 778, "limit": 3, "offset": 0,
            "attribution": "Datos por Pangui — https://panguiapp.com" }
}

Filtros

# Restaurantes con beneficio en Providencia
curl -s "https://api.panguiapp.com/beta/offers?category=restaurante&comuna=Providencia" \
  -H "Authorization: Bearer $PANGUI_KEY"

# El segmento municipal
curl -s "https://api.panguiapp.com/beta/offers?issuer=vecino-las-condes" \
  -H "Authorization: Bearer $PANGUI_KEY"

# Todos los emisores, con su tipo
curl -s "https://api.panguiapp.com/beta/issuers" -H "Authorization: Bearer $PANGUI_KEY"

El snapshot del día

curl -s "https://api.panguiapp.com/beta/snapshot" -H "Authorization: Bearer $PANGUI_KEY" \
  -o pangui.ndjson.gz
gunzip -c pangui.ndjson.gz | head -n 1

Con la key demo el snapshot es una muestra de ~100 ofertas repartidas entre emisores y categorías; con una key nominal es el catálogo completo del día.

¿Y ahora?

• Modelo de datos: cada campo y por qué las fechas no son instantes.
• Sincronización: cómo mantener una copia al día sin perder bajas.
• ¿Quieres una key nominal? Escríbenos a contacto@panguiapp.com contando qué producto vas a construir.