Civicamente

API pour la recherche civique

Documentation et accès aux données agrégées : authentification, limites de l’échantillon et conditions d’utilisation.

À quoi sert l’API ?

L’API fournit des données agrégées pour explorer les résultats et tendances des participants à Civicamente. Elle s’adresse à la recherche et à l’éducation ; les données ne représentent pas l’ensemble de la population.

Comment y accéder ?

Consultez la spécification OpenAPI pour les endpoints, paramètres et mécanismes d’authentification. Les endpoints protégés nécessitent une clé autorisée. Vérifiez disponibilité, quotas et conditions de réutilisation avant toute intégration.

Quelles sont les limites des données ?

La participation est volontaire. Langue, couverture géographique, taille des groupes et versions du test peuvent affecter les comparaisons. Ne cherchez pas à identifier les participants ni à présenter l’échantillon comme un sondage représentatif.

Exemples de requêtes

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()