What are we mad about today?
Access our dystopia data programmatically. Free for nonprofits, researchers, and journalists.
All endpoints return JSON. No authentication required for read-only public data. Rate limited to 60 requests/minute per IP.
/api/articlesFetch articles with filters and pagination
Parameters
countriesstringComma-separated ISO country codes (US,GB,RU)statesstringComma-separated US state codes (TX,CA)typesstringComma-separated dystopia types (surveillance,corruption)severitystringComma-separated levels (critical,apocalyptic)sourcesstringSource types (mainstream,independent)timestringtoday, week, monthsortstringnewest, oldest, severity_high, severity_lowqstringFull-text search querylimitnumberResults per page (max 100, default 40)cursorstringPagination cursor (created_at of last item)/api/articles/searchFull-text search across articles
Parameters
qstringSearch query (min 2 chars)limitnumberMax results (default 40)/api/dystopia-indexCurrent dystopia scores by country
/api/dystopia-index/historyHistorical dystopia score time series
Parameters
countrystringISO country codetypestringDystopia type filterdaysnumberLookback period (default 30)/api/dystopia-index/statesUS state-level dystopia scores
/api/timelineReal-time timeline data computed from articles
Parameters
countriesstringComma-separated country codesglobalbooleanInclude global aggregate (true/false)daysnumberLookback period/api/banned-booksBanned books database (20,000+ entries)
Parameters
statestringUS state codeqstringSearch title/authordecisionstringBanned/Removed, Restricted, Retained, PendingyearnumberYear of bansortstringban_count_desc, ban_date_desc, title_asc, etc.pagenumberPage numberlimitnumberResults per page (max 200)/api/feedRSS 2.0 feed of latest articles
theocracyauthoritarianismfascismcorruptionsurveillancecensorshipmilitary_aggressioneconomic_exploitationenvironmental_destructionpropagandavoter_suppressionpolice_stateThe data is open. The methods are transparent. Use it to build something that matters.