Build on the Commons

Open data. An open API.
For anyone to build on.

Query the Commons by area and type, or download the weekly bulk export and host it yourself. The data is open (ODbL), which is what makes it a commons. No key, no account, no charge: a rate limit and fair use are the whole of it.

Browse the interactive API reference, which lists every endpoint with its parameters and answers, or the spec on GitHub.

Endpoints
GET/v1/searchfind coverage by bbox, letter, tier
GET/v1/items/{id}one item: its kind, the details picked from a list, its photos and where it comes from
GET/v1/regions/{id}one region: its outline and what it holds, letter by letter
GET/v1/regions/{id}/bestwhat riders voted best in a region this season
GET/v1/routes/{id}.gpxa route's track, as a GPX file to download
GETcoverage.pmtilesvector tiles per country, listed by /v1/map-config, to bind into your own MapLibre style
POST/v1/contributionsfor registered partner apps: lands in the same review queue as contributions on the site

The bulk export: what is in it, the licence and the snapshots →

Example request
# drinking water & food in a bounding box
curl --compressed "https://api.cyclingcommons.org/v1/search\
  ?letter=B&bbox=5.6,50.3,6.1,50.6"
Response
{
 "type":"FeatureCollection",
 "licence":"ODbL-1.0",
 "features":[{
  "type":"Feature",
  "geometry":{"type":"Point",
   "coordinates":[5.865,50.492]},
  "properties":{
   "id":4512, "letter":"B",
   "name":"Fountain · Spa",
   "tier":"curated", "grade":"minimum",
   "confirmations":3, "region_id":"wallonia", …
  }
 }]
}

Responses are reference-only by default: our own fields, and on one item (/v1/items/{id}) the osm_ref to hydrate against OSM. ?hydrate=osm merges our cached OSM subset in for you.

Required attribution
Contains data from the
Cycling Commons © contributors
and © OpenStreetMap contributors,
under the Open Database License.
Photos © their creators,
under the licence named with each photo.
Code, user interface and translations
© their contributors, under AGPL-3.0-only.
The rules
Fair use. Reads are open to anybody, with no key and no account, within a rate limit per address that a normal app stays well below. For bulk or offline use, download the weekly bulk export and host it yourself instead of hammering the live API; scraping the service is not allowed. Licences: data ODbL 1.0, media CC BY-SA 4.0. Attribute, share alike, keep open. Commercial use is fine. See the plain-language summary: Licensing.