Free public API
Everything on this site is available as static JSON — free, no key, CORS-enabled, cached at the edge. Attribution appreciated but not required (the underlying government data is public domain; tax data is via the Tax Foundation). Please don't hammer it — it's a static file.
Endpoints
GET /api/v1/states.json | All 50 states and DC, with every metric + the source registry. |
GET /api/v1/states/{postal}.json | One state (lowercase, e.g. /api/v1/states/ca.json). |
GET /api/v1/metros.json | All BEA metropolitan areas, with RPP values by component and source metadata. |
GET /api/v1/sources.json | The source registry alone (datasets, vintages, URLs). |
Example
curl https://statenumbers.com/api/v1/states/al.json
Shape
Each state carries rpp (price parity by component), rpp_history,unemployment, housing (ACS estimates and 90% margins of error),trends, and taxes (manually maintained). Housing includes median rent, home value, household income, cost-to-income ratios, and real-estate taxes paid. Missing values are null — never modeled or filled. Every dataset in sources states its vintage, release, and whether it is API-sourced or manually maintained.
The metro response carries a meta object and a metros array. Each metro has a Census area code, display name, associated state abbreviations, and all-items, housing-rent, goods, utilities, and other-services RPP values.