API per la ricerca civica

A cosa serve l’API?

L’API espone dati aggregati per esplorare risultati e tendenze dei partecipanti a Civicamente. Si rivolge a progetti di ricerca ed educazione; i dati non sono una misura rappresentativa dell’intera popolazione.

Come si accede?

Consulta la specifica OpenAPI per endpoint, parametri e autenticazione. Gli endpoint protetti richiedono una chiave autorizzata. Disponibilità, quote e condizioni di riuso vanno verificate prima di avviare un’integrazione.

Quali limiti hanno i dati?

La partecipazione è volontaria. Lingua, copertura geografica, dimensioni dei gruppi e versioni del test possono influenzare i confronti. Non usare gli aggregati per dedurre l’identità dei partecipanti o presentare un campione come un sondaggio rappresentativo.

Esempi di richiesta

curl "https://www.civicamente.ch/api/v1/datasets/overview?country_iso=CH" -H "X-API-Key: YOUR_API_KEY"

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

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