Data & API
Our city data and rankings are free to use. Journalists, researchers, students and developers: build with them, and link back to us.
Terms
- Attribution: credit “USCity.review” with a link to
https://uscity.reviewwherever you use our rankings or scores. - Underlying data: each dataset keeps its own license, listed on Data & methodology. Anything derived from OpenStreetMap carries its ODbL share-alike terms and needs the “© OpenStreetMap contributors” credit.
- Fair use: the API allows 60 requests per minute per IP. Cache responses; the data changes at most daily.
- No guarantees: scores are relative and for general information. Please read the methodology before drawing conclusions.
JSON API (v1)
Base URL: https://uscity.review/api/v1. Responses are JSON; list endpoints are paginated (per_page up to 100).
| Endpoint | Description |
|---|---|
| GET /cities | Search cities. Filters: q, state, county, type, min_population, max_population, zip, sort. |
| GET /cities/{slug} | One city with ZIP codes, ranking positions and current metrics by source. |
| GET /rankings | Published rankings and the metrics and weights behind each. |
| GET /rankings/{slug} | Entries of a ranking, optionally limited with state=TX. |
curl "https://uscity.review/api/v1/rankings/walkable-cities?state=TX&per_page=5"CSV downloads
Every ranking page has a CSV of positions, scores and the percentile of each metric behind a score: https://uscity.review/rankings/walkable-cities.csv. See the rankings.
Embeddable badges
Cities and local businesses can show where a city ranks. Open a city page and use the Share & embed box for ready-made HTML, or build the URL yourself:
<a href="https://uscity.review/cities/austin-tx"><img src="https://uscity.review/embed/badge/austin-tx/walkable-cities.svg" alt="Austin ranking" width="300" height="90"></a>Questions or a dataset request? Contact us.