Civicamente

API para investigación cívica

Documentación y acceso a datos agregados de investigación cívica: autenticación, límites de la muestra y condiciones de uso.

¿Para qué sirve la API?

La API ofrece datos agregados para explorar resultados y tendencias de participantes de Civicamente. Está orientada a investigación y educación; no representa a toda la población.

¿Cómo se accede?

Consulta la especificación OpenAPI para conocer endpoints, parámetros y autenticación. Los endpoints protegidos requieren una clave autorizada. Verifica disponibilidad, cuotas y condiciones de reutilización antes de integrar el servicio.

¿Qué límites tienen los datos?

La participación es voluntaria. Idioma, cobertura geográfica, tamaños de grupo y versiones del test pueden afectar las comparaciones. No uses los agregados para identificar participantes ni presentar la muestra como una encuesta representativa.

Ejemplos de solicitud

curl
curl "https://www.civicamente.ch/api/v1/datasets/overview?country_iso=CH" -H "X-API-Key: YOUR_API_KEY"
Python
import os, requests
response = requests.get(
    "https://www.civicamente.ch/api/v1/datasets/overview",
    params={"country_iso": "CH"},
    headers={"X-API-Key": os.environ["CIVICAMENTE_API_KEY"]},
    timeout=30,
)
response.raise_for_status()
print(response.json())
R
library(httr2)
request("https://www.civicamente.ch/api/v1/datasets/overview") |>
  req_url_query(country_iso = "CH") |>
  req_headers(`X-API-Key` = Sys.getenv("CIVICAMENTE_API_KEY")) |>
  req_perform() |>
  resp_body_json()