# ESPOT DATA API · v1

API REST con datos economicos reales de Mexico.
Base URL: https://espot.mx/api/v1
Autenticacion: Authorization: Bearer esp_live_xxx  (header o ?api_key=)
Rate limit: por plan (free 100 req/mes · basic 10k · pro 100k · enterprise ilimitado)
Formato: JSON · CORS habilitado · < 200ms p50

## Endpoints disponibles

GET /api/v1/tipo-cambio
  Tipo de cambio USD/MXN y otros pares (Banxico FIX).
  Sin parametros · health check publico.

GET /api/v1/gasolina?municipio=guadalajara&tipo=magna&limit=20
  Precios de gasolina por municipio (Magna/Premium/Diesel).
  Fuente: gasolina_spot_precios (CRE + datos ciudadanos).

GET /api/v1/precios?ciudad=guadalajara&producto=jitomate
  Precios PROFECO por producto y ciudad.

GET /api/v1/score?municipio=zapopan
  Score de calidad de vida por municipio (ESPOT SCORE).

GET /api/v1/negocios?ciudad=guadalajara&categoria=restaurante&limit=20
  Directorio DENUE por ciudad y categoria.

GET /api/v1/aire?ciudad=guadalajara
  Calidad del aire (IMECA) por ciudad.

GET /api/v1/servicios?ciudad=guadalajara&servicio=plomero
  Precios reales de servicios locales (ESBOT).
  Unico en Mexico · sin equivalente en IMSS ni INEGI.

## Endpoints adicionales (bonus)

GET /api/v1/clima      ·  clima actual por ciudad
GET /api/v1/sismos     ·  sismos recientes
GET /api/v1/presas     ·  nivel de presas
GET /api/v1/inflacion  ·  INPC quincenal (INEGI)
GET /api/v1/seguridad  ·  crimenes por municipio
GET /api/v1/dolar      ·  paridad USD-MXN historico

## Planes

Free       · 100 req/mes       · $0
Basic      · 10,000 req/mes    · $29 USD/mes
Pro        · 100,000 req/mes   · $99 USD/mes
Enterprise · Volumen ilimitado · $499 USD/mes  (SLA 99.9% · soporte dedicado)

## Obtener una API key

Registro: https://espot.mx/developers
Soporte:  hola@espot.mx

## Formato de respuesta

{
  "ok": true,
  "data": [...],
  "meta": {
    "timestamp": "2026-04-17T00:00:00Z",
    "source": "ESPOT DATA API",
    "endpoint": "gasolina",
    "count": 20
  }
}

## OpenAPI spec
https://espot.mx/openapi.json

---
Plain-text version for AI assistants.
Full docs: https://espot.mx/developers