EleccionesDB API
¿Qué es EleccionesDB API?
EleccionesDB API es una API REST de solo lectura para consultar resultados electorales españoles. Proporciona acceso estructurado a datos de elecciones generales, autonómicas, municipales, europeas y al Senado desde 1977 hasta la actualidad.
La API permite consultar:
- Elecciones: catálogo de tipos, listado histórico y detalle de cada convocatoria.
- Territorios: jerarquía completa desde comunidades autónomas hasta secciones censales.
- Partidos: búsqueda por siglas, agrupaciones lógicas (recodes) y detalle.
- Resultados: totales territoriales (censo, participación, votos), votos por partido y resultados combinados con todas las relaciones expandidas.
Tecnologías
| Componente | Tecnología |
|---|---|
| Framework web | FastAPI |
| Base de datos | PostgreSQL |
| ORM | SQLAlchemy 2.0 |
| Validación | Pydantic v2 |
| Contenedorización | Docker + Docker Compose |
| Servidor ASGI | Uvicorn |
Secciones de esta documentación
- Referencia API — Catálogo completo de endpoints, parámetros y filtros.
- Esquema de base de datos — Tablas, relaciones y diagrama ER.
- Ejemplos de uso — Peticiones y respuestas reales de la API.
- Guía de despliegue — Instrucciones para poner en marcha la API con Docker.