SmogRank / Data and API

Data and API

Everything on this site is free to read and to cite. For businesses that need more than a page, SmogRank sells city-level figures made from the monitors whose licences allow it.

Free

  • Every page: the rankings, city pages and their histories, past boards, the map and the guides.
  • Quoting and citing figures and rankings, with a credit and a link, and each city's chart as a PNG.
  • The city widget for your own site.
  • Each city's bad-air days and the list of bad-air episodes as Atom feeds.
  • The values Sensor.Community's sensors set, month by month, under the ODbL (listed on the sources page, files under /data/sensor-community/).
  • Our MCP server for AI assistants (https://smogrank.com/mcp): today's reading, ranks and city search always, and 20 calls a day of a city's daily history.

Paid

  • Daily-history calls on the MCP server past the 20 free each day: US$0.01 a call, paid in USDC on Base with x402. The assistant's client pays as it calls; there is no account or key. A call for a city whose figures draw on a source under “Never in a paid product” below is never charged.
  • A finished year's file of daily city figures: each city's daily mean PM2.5 and its daily rank, for every city on open-licence monitors: US$490.
  • Figures made to order, by quote: for example, smoke days per summer in each city a company ships to, or a town's record against the big city nearby.

To buy either, write to hello@smogrank.com with what you need. We reply with a sample, and an invoice once you agree.

Which sources a paid product uses

Only monitors whose licence or publisher's terms allow commercial use and redistribution, without share-alike. Each network's licence or terms are on the sources page.

Never in a paid product: government readings published with no reuse terms (marked on the sources page), the values Sensor.Community's sensors set (free under the ODbL instead), and Korea, Thailand, Chile and South Africa, whose permission we have asked for.

Paid figures are city-level: daily means, ranks and what a city usually reads at that time of year. Never a monitor's own readings or its hourly series.

How to credit it

Credit SmogRank (smogrank.com) and the networks behind the figures, named in each file, for example: “PM2.5 daily means from SmogRank (smogrank.com); monitor data from AirNow (US EPA), via OpenAQ.” A publisher that asks for a particular credit gets it word for word; the file says which.