About ctzn.pub
Public data, computed carefully and published openly.
ctzn.pub turns the country's public surveys and records into essays, interactive apps and charts: the General Social Survey, the American National Election Studies, CDC and Census data, and more. Every figure uses its survey's own weights and links to its source.
From source data to a published essay
The same four steps for every essay on the site.
Public sources
Survey and government data, downloaded from the original source and saved as a fixed copy, so results stay the same when a source updates.
Careful computation
Each estimate uses the survey’s own weights and rules. Groups too small to report reliably are combined or left out, and labelled.
Essays and apps
Results become interactive charts and maps inside long-form essays that explain what the data shows. Every figure names its source.
Readable by machines
Every essay is also published as Markdown and structured data for research tools and AI assistants. A full API is in development.
A statistician reviews every analysis
Before we compute anything from a new source, we write the full analysis plan into one readable document: which weights, which groups, what gets combined or left out, and the exact wording of each finding. A statistician reviews the plan and approves it.
Nothing is computed until the plan is approved, and if the plan changes, it goes back for review. When a survey changes how it's run, our charts show the break instead of drawing one smooth line through it.
One mistake in a plan would repeat across thousands of numbers. So a person approves every plan first.
What every figure meets
- Weighted and sourced
- Every figure uses its survey’s weights and links to the exact source.
- Tied to a fixed copy of the data
- Every essay says which version of the data it uses. We update it when a source publishes new data.
- Readable by machines
- Markdown copies, a claims feed and structured data for research tools and AI assistants.
- Built for reading
- Interactive charts and maps designed for long-form reading, for researchers and journalists first.
Who runs this
ctzn.pub is built and run by a small team working directly with the survey methodology — the same people who compute the figures, write the essays, and review every published number.
Contact
Questions about a figure, a correction, a licensing question, or interested in the institutional library — reach us directly.
info@ctzn.pubMachine surfaces
What machines can read today: Markdown mirrors of every published article, a machine-readable claims feed, and structured data on every article page. No key required — these are public, crawlable surfaces.
Markdown mirrors
Every published article is also served as clean, extraction-friendly Markdown — prose intact, each chart replaced by its sourced takeaway.
GET /api/md/<username>/<slug>Claims feed
A machine-readable feed of sourced findings from published articles — the numbers, their source surveys, and the article they came from.
GET /claims.jsonStructured data
Published articles carry Schema.org JSON-LD (Article + Dataset), so search and answer engines can attribute every figure.
application/ld+json on article pagesOpen to AI crawlers
robots.txt explicitly welcomes GPTBot, ClaudeBot, PerplexityBot and peers across all public content.
GET /robots.txt{
"generated": "2026-07-03T22:14:36.012Z",
"count": 2,
"claims": [
{
"article": "The widening mental health gap among US teens",
"url": "https://uma.ctzn.pub/the-widening-mental-health-gap-among-us-teens-wyl28",
"title": "Poor Mental Health Among US High School Students",
"source": "YRBS",
"takeaway": "Female: 40.8 (2021) → 38.8 (2023), -2.0; Male: 18.1 (2021) → 18.8 (2023), +0.8."
}
]
}On the roadmap
A full public REST API and MCP server over the article and claims catalog is in development and not yet available. Nothing on this page requires a key or a plan — when a metered API ships, it will be documented here first.