Data & API
Every score, description, and source on this site is available for research use: as plain files you can load into pandas or R, and as a queryable read-only API covering score history, the sources database, verified policy-initiative records, and per-run provenance. How the scores are constructed is documented in the methodology.
Download the dataset
One HTTP GET each, no key, CDN-served. These files update together, monthly, and their git history makes any past state retrievable by commit hash.
| File | Contents |
|---|---|
| scores.csv | 196 countries × six 1–5 scores (quarter-point decimals), last-updated date, data version. |
| regulation_data.csv | Per-country prose for the five dimensions, key legislation, source URLs, confidence. |
| history.json | Change-point score snapshots per country; the timeline's raw data. |
| subscores.json | The four named sub-indicators (integers 1–5) behind each dimension score. |
| country_iso.json | ISO 3166 alpha-2 / alpha-3 / numeric codes for every dataset country name. |
The read-only API
The database behind the site is publicly queryable through PostgREST. The interactive API reference documents every endpoint, column, and filter (generated from the database schema itself), and runs queries against the live API from the browser.
| Endpoint | Contents |
|---|---|
| /public_export | The whole dataset flat: countries × scores × summaries. |
| /countries | Canonical names, ISO codes, and name aliases. |
| /country_scores | Current scores, incl. the sub-indicator breakdown (subscores). |
| /country_summaries | Per-dimension prose, key legislation, raw source list. |
| /score_history | Every score a country has ever carried, with dates. |
| /sources_export | The accumulating sources database, with citing countries. |
| /policy_initiatives | Verified policy-initiative records (OECD.AI / GAIIN). |
| /research_runs | Provenance: every research run, its model and prompt version. |
From your own scripts, authenticate with the public read-only token, in a header
or as an apikey query parameter. Add Accept: text/csv
for CSV instead of JSON:
curl "https://wlakioilvvuuizxdhsdf.supabase.co/rest/v1/public_export?select=country,iso3,avg_score&order=avg_score.desc.nullslast&limit=10" \ -H "apikey: sb_publishable_mANlk3lYBOM8DWDKUjvhRg_yq0TyTEM"
Standard PostgREST
filter syntax works everywhere: column=eq.value, gte./lte.,
order=, limit=/offset=, and embedded joins like
countries!inner(name). Responses are capped at 1,000 rows per request;
page with limit/offset.
The API is infrastructure for research convenience. For archival reproducibility, cite the static files above or keep a copy of your extract.
Recipes
Worked queries that answer real research questions. Open runs the query live in a new tab; the path works as-is in the reference, curl, or your own code.
Attribution & citation
Policy-initiative records include data from the OECD.AI Policy Observatory (Policy Navigator / GAIIN): OECD.AI Policy Observatory, oecd.ai, accessed on the date shown per record.
To cite the map itself, use the Share button in the app for a
formatted APA/Chicago/MLA citation of the exact view you're referencing. Scores are
model-assigned; the methodology and the
research_runs endpoint record how each one was produced. Cite them as
estimates, and verify claims against the primary sources each entry links.