P Polímetro Colombia
API para desarrolladores
Datos públicos de transparencia política de Colombia, en JSON. Gratis para empezar.
Inicio rápido

Base URL:

https://polimetro.org/api/v1
curl "https://polimetro.org/api/v1/senators?per_page=5"

La API responde JSON paginado con data, links y meta.

Autenticación

El acceso anónimo es gratis (limitado por IP). Para límites mayores, envía tu clave en el encabezado X-Api-Key: 

curl -H "X-Api-Key: pmk_xxx" "https://polimetro.org/api/v1/people?department=Valle%20del%20Cauca"

Inicia sesión para generar una clave.

Planes y límites
PlanPrecioSolicitudes/minSolicitudes/mes
Free Gratis 30 1,000
Basic $5/mes 60 10,000
Pro $10/mes 120 30,000
Business $20/mes 300 100,000

Mejora tu plan en Planes.

Endpoints
GET
/api/v1/people

Todos los políticos (filtros: q, position, department, municipality, party, status, active, year, term_start, term_end, from, to, per_page)

Solicitud
curl "https://polimetro.org/api/v1/people?department=Valle%20del%20Cauca&from=2024-01-01&to=2027-12-31"
Respuesta
{"data":[{"name":"Audry María Toro Echavarría","position":"councilor","party":"Partido de la Unión por la Gente","department":"Valle del Cauca","municipality":"Santiago de Cali","term_start":"2024-01-01","term_end":"2027-12-31"}],"links":{"first":"…","next":null},"meta":{"total":1,"per_page":25}}
GET
/api/v1/people/{slug}

Un político por slug

Solicitud
curl "https://polimetro.org/api/v1/people/audry-maria-toro-echavarria"
Respuesta
{"data":{"name":"Audry María Toro Echavarría","position":"councilor","position_label":"Concejal","party":"Partido de la Unión por la Gente","municipality":"Santiago de Cali"}}
GET
/api/v1/senators

Senadores (igual: representatives, governors, mayors, deputies, councilors)

Solicitud
curl "https://polimetro.org/api/v1/senators?per_page=2"
Respuesta
{"data":[{"name":"…","position":"senator","position_label":"Senador"}],"meta":{"total":103,"per_page":2}}
GET
/api/v1/parties

Partidos con conteo de políticos

Solicitud
curl "https://polimetro.org/api/v1/parties"
Respuesta
{"data":[{"id":1,"name":"Partido Alianza Verde","short_name":null,"color":null,"politicians_count":12}],"meta":{"total":30}}
GET
/api/v1/positions

Cargos disponibles (valor, etiqueta, conteo)

Solicitud
curl "https://polimetro.org/api/v1/positions"
Respuesta
{"data":[{"value":"senator","label":"Senador","count":103},{"value":"mayor","label":"Alcalde","count":1103}]}
GET
/api/v1/regions

Regiones con conteo de departamentos

Solicitud
curl "https://polimetro.org/api/v1/regions"
Respuesta
{"data":[{"id":1,"code":null,"name":"Caribe","departments_count":7}]}
GET
/api/v1/regions/{region}/departments

Departamentos por región (id, código o nombre)

Solicitud
curl "https://polimetro.org/api/v1/regions/Caribe/departments"
Respuesta
{"data":[{"id":8,"code":"08","name":"Atlántico","capital":"Barranquilla"}]}
GET
/api/v1/departments

Departamentos (filtro: q)

Solicitud
curl "https://polimetro.org/api/v1/departments?q=Valle"
Respuesta
{"data":[{"id":24,"code":"76","name":"Valle del Cauca","capital":"Cali"}],"meta":{"total":1}}
GET
/api/v1/departments/{department}/municipalities

Municipios por departamento (id, código o nombre)

Solicitud
curl "https://polimetro.org/api/v1/departments/76/municipalities"
Respuesta
{"data":[{"id":900,"code":"76001","name":"Santiago de Cali","department":"Valle del Cauca"}],"meta":{"total":42}}
GET
/api/v1/municipalities

Municipios (filtros: q, department)

Solicitud
curl "https://polimetro.org/api/v1/municipalities?department=Valle%20del%20Cauca"
Respuesta
{"data":[{"id":900,"code":"76001","name":"Santiago de Cali","department":"Valle del Cauca"}],"meta":{"total":42}}