Civicamente

API für Bürgerforschung

Dokumentation und Zugang zu aggregierten Forschungsdaten: Authentifizierung, Stichprobengrenzen und Nutzungsbedingungen.

Wozu dient die API?

Die API stellt aggregierte Daten zu Ergebnissen und Trends der Civicamente-Teilnehmenden bereit. Sie unterstützt Forschung und Bildung; die Daten sind nicht repräsentativ für die Gesamtbevölkerung.

Wie erhalte ich Zugang?

Endpunkte, Parameter und Authentifizierung stehen in der OpenAPI-Spezifikation. Geschützte Endpunkte erfordern einen autorisierten Schlüssel. Prüfen Sie Verfügbarkeit, Kontingente und Nutzungsbedingungen vor einer Integration.

Welche Grenzen haben die Daten?

Die Teilnahme ist freiwillig. Sprache, geografische Abdeckung, Gruppengrösse und Testversion können Vergleiche beeinflussen. Aggregate dürfen nicht zur Identifizierung von Teilnehmenden oder als repräsentative Umfrage dargestellt werden.

Beispielanfragen

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