Photon (Komoot) API

Base URL

https://photon.komoot.io/api

Authentication

No API key required on the public instance.

Rate limit

No published hard limit, but the public instance is a courtesy — self-host for production.

Pricing

Free and open source. Data is ODbL, requiring OpenStreetMap attribution.

CORS

Not enabled — call it from your server

Official docs

Read the docs

Every request below was executed against the live API on 20 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://photon.komoot.io/api/?q=berlin&limit=1'

const res = await fetch("https://photon.komoot.io/api/?q=berlin&limit=1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://photon.komoot.io/api/?q=berlin&limit=1", timeout=20)
res.raise_for_status()
print(res.json())

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "osm_type": "R",
        "osm_id": 62422,
        "osm_key": "place",
        "osm_value": "city",
        "type": "city",
        "name": "Berlin",
        "country": "Deutschland",
        "countrycode": "DE",
        "extra": {
          "admin_level": "4"
        },
        "extent": [
          13.088345,
          52.6755087,
          13.7611609,
          52.3382448
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          13.3951309,
          52.5173885
        ]
      }
    }
  ]
}

typestring

FeatureCollection — the response is GeoJSON.

features[].geometry.coordinatesarray

[longitude, latitude] — note the order.

features[].properties.namestring

Place name.

features[].properties.country / state / citystring

Administrative context.

features[].properties.osm_id / osm_typeinteger|string

OpenStreetMap object reference.

features[].properties.typestring

Feature classification such as city or street.

• Build a fast location autocomplete box
• Geocode addresses without Nominatim's one-per-second limit
• Bias search results towards the user's current position
• Self-host geocoding for privacy or volume

If Photon (Komoot) does not fit, these geolocation & ip apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.