Population estimates: totals and median age across a geography level
Changed onResident population and median age from the Census Bureau's Population Estimates (<vintage>/pep/charv), one estimate year (2020 to the latest published vintage). The vintage folder is the dataset; YEAR is a predicate inside it. 2020 carries an April 1 census-base row and a July 1 estimate, labelled; later years are July 1. Totals are both sexes and all ages (SEX=0, AGE=0000) with median age from the PEP_AGESEX group. geo is the nation, every state (or one, including PR), the counties of one state, or every metro area. A year past the latest is an empty answer with a reason.
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/census/population/estimates
- Auth: API key in header x-api-key
Query parameters
Estimate year (YYYY, 2020 to the latest published; required).
us (one national row), state (every state, or one with state=), county (the counties of one state; state= required) or msa (every metropolitan and micropolitan area).
State postal code (CA, TX, DC, PR, ...) when geo=state or county.
Response
One row per geography (and per month in 2020), in FIPS or CBSA order.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"data_age_days": 8.532,
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
],
"stale_since": "2026-09-08T12:00:00Z",
"period": "2026-Q1",
"notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
}
}Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
added the non-success response with the status
- info