Documentación API

• Local: http://localhost:4000
• Producción: https://api.legislometro.com

Crea una key en Dashboard → API keys. El secreto (lm_test_… / lm_live_…) solo se muestra una vez.

Envíala en cada request:

curl -sS "https://api.legislometro.com/v1/rankings?limit=5" \
  -H "Authorization: Bearer $LM_API_KEY"

Alternativa: header x-api-key.

Misma API HTTP v1 en todos los niveles. Lo que cambia es la cuota, el rate limit y las keys incluidas. API, API Pro y API Business se contratan en Precios; Enterprise por [email protected].

La cuota mensual es por cuenta (compartida entre todas tus keys). Al exceder rate limit o cuota: HTTP 429 con Retry-After. Reinicio mensual en UTC.

Headers de uso en cada respuesta autenticada:

X-RateLimit-Limit: 10
X-RateLimit-Remaining: 7
X-RateLimit-Reset: 1786400000
X-Monthly-Limit: 1000000
X-Monthly-Remaining: 827419
X-Monthly-Reset: 2026-09-01T00:00:00.000Z

Consulta consumo del mes y límites del plan.

curl -sS "https://api.legislometro.com/v1/account/usage" \
  -H "Authorization: Bearer $LM_API_KEY"

Colecciones: page (default 1), limit (default 50, máximo 100; feed máximo 50).

{
  "data": [],
  "pagination": { "page": 1, "limit": 50, "total": 1452, "totalPages": 30 }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Unauthorized"
  }
}

• 400 invalid_request
• 401 invalid_api_key
• 403 api_access_required
• 429 rate_limit_exceeded / monthly_quota_exceeded
• 500 internal_error

Listado paginado del ranking. No incluye la fórmula interna.

Query: legislature, period, page, limit, q, state, party, representation (RELATIVE_MAJORITY | PROPORTIONAL_REPRESENTATION).

curl -sS "https://api.legislometro.com/v1/rankings?limit=5&state=JALISCO" \
  -H "Authorization: Bearer $LM_API_KEY"

También: GET /v1/rankings/:legislatorId.

Perfil completo (equivalente a Pro en el sitio): métricas, actividad, votos y asistencias.

Query: legislature, period, voto, asistencia, tema.

curl -sS "https://api.legislometro.com/v1/legislators/jose-elias-lixa-abimerhi" \
  -H "Authorization: Bearer $LM_API_KEY"

Listado de estados. Detalle: GET /v1/states/:state (slug o clave, p. ej. jalisco).

curl -sS "https://api.legislometro.com/v1/states/jalisco" \
  -H "Authorization: Bearer $LM_API_KEY"

Actividad reciente. Query: limit, page, type (INITIATIVE | VOTE | ABSENCE), q.

curl -sS "https://api.legislometro.com/v1/feed/recent?limit=10&type=VOTE" \
  -H "Authorization: Bearer $LM_API_KEY"

• Descarga masiva de PDFs
• Overages / facturación por uso
• Rutas /internal/*, billing y admin

Especificación en el repo: docs/api-v1.md.