The Mapzen Places API allows developers (and robots) programmatic access to query and retrieve Who’s On First data via a REST-ish interface.

API methods are dispatched over HTTP with one or more query parameters and data is returned in response as JSON by default but you may also specify CSV or Who’s On First’s own meta formatted responses for certain API methods.

The endpoint for the Mapzen Places API is: https://places.mapzen.com/v1/

If you’re wondering the chances that there will ever be a /v2 are slim-to-never.

All errors are returned using HTTP status codes in the 400-599 range.

400 class errors mean the problem was on your end and 500 class errors mean the problem was our fault.

Caveats

The API is not feature complete yet, which is to say it will keep growing as time goes by. The easiest way to think about the Mapzen Places API is to look at the Who’s On First Spelunker website and imagine that anything you can do there to search and navigate all those places should also be possible via the API. As of this writing it is not but we’ll get there. If there is anything currently missing that you’d like or need to do sooner than later send up a flare and we’ll see about adding it to the list.

Some API methods are flagged as being experimental which means that both either their inputs or their outputs may change without warning. We’ll try not to introduce any backwards incompatible changes but you should approach these API methods defensively.

API Keys

To use the Mapzen Places API, you should first obtain a free developer API key.

Rate limits

See the Mapzen developer overview for more on API keys and rate limits.