Citytistics
Shortlist
Developers

Citytistics API.

Sourced, comparable place data over REST. JSON or CSV. One key, metered monthly.

Quick start

curl -H "x-api-key: YOUR_KEY" \
  "https://www.citytistics.com/api/v1/places/new-york-new-york"

Keys come with the API plan, which is not on sale yet. See pricing.

Endpoints

GET/api/v1/places
List places. Filters: state, min_pop, indexable. Add format=csv for CSV.
GET/api/v1/places/{slug}
One place with all metrics, history and quality flags.
GET/api/v1/metros
List metro areas (CBSA). Filter: state.
GET/api/v1/metros/{slug}
One metro area.
GET/api/v1/openapi.json
OpenAPI 3.1 description of this API.

Response shape

{
  "meta": { "as_of": "2024 ACS 5-year", "sources": ["..."] },
  "data": {
    "slug": "new-york-new-york", "name": "...", "state": "GA",
    "population": 0, "median_household_income": 0, "median_gross_rent": 0,
    "rent_to_income_pct": 0, "quality": { "indexable": true, "reasons": [] }
  }
}

Errors and limits

401Missing or invalid key.
429Monthly quota reached. Quotas reset on the 1st.
503Metering unavailable. We fail closed rather than serve unmetered.

Licensing

Source data is public (Census, IRS, HUD, BLS, FBI, NCES, National Park Service and OpenStreetMap). You pay for the cleaning, joining, history and uptime. Attribution "Data: Citytistics" is required on public displays, and OpenStreetMap-derived fields also need "© OpenStreetMap contributors" under the ODbL.