OpenStreetMap · worldwide · updated daily

Free worldwide geocoding API

Address → coordinates, coordinates → address, autocomplete and Overpass. Compatible with Nominatim and Photon.

GET /photon/api
// Start typing an address or click the map
🌍 Worldwide every country Nominatim search & reverse Photon autocomplete Overpass OSM queries Tiles basemap
Sandbox

Try it online

Pick a service and click an example or change the parameters — the request goes to the real server and the result shows up on the map and as JSON. No key needed; copy the request URL straight into your code.

Features

What the geocoding API does

🌍

The whole world, not one country

The full OpenStreetMap database: every country and territory, city, street, building and place. Data is updated daily, and names come in any language available in OpenStreetMap: English, German, Chinese, Arabic, Russian and more.

All countriesDaily updatesAny language

Forward geocoding

Address, city or place name → latitude, longitude and a structured address. Method /search.

Reverse geocoding

Coordinates → nearest house, street, city, region and country. Method /reverse.

Address autocomplete

Search-as-you-type for addresses and cities in your forms, powered by Photon. Method /photon/api.

Time zone

Parameter timezone=1 adds the IANA time zone, e.g. Europe/Moscow.

Overpass API — query any OpenStreetMap objects

All pharmacies within a kilometre, bus stops along a street, schools in a district, land boundaries — any OSM objects by tags and area in Overpass QL. The database is updated daily. Method /overpass.

Map tiles — a basemap for the whole world

Raster PNG (standard and retina) for Leaflet and OpenLayers, vector tiles and a ready-made MapLibre GL style. No separate map provider needed: geocoder and basemap with one key. Methods /tiles/{z}/{x}/{y}.png, /tiles/style.json.

Docs

Getting started

Primary endpoint — https://api.beegeo.ru, backup — https://api2.beegeo.ru (same keys and methods; configure it as a fallback for maintenance windows). Pass the key as the key= parameter or the X-Api-Keyheader. Responses are JSON, UTF-8. Name language — the accept-language (ru, en, de, kk…) parameter; for Photon — lang.

Live examples for every method are in “Try it online”. All parameters, response languages, errors and code samples are in the full documentation.

Python

import requests

KEY = "YOUR_KEY"
r = requests.get("https://api.beegeo.ru/search",
    params={"q": "Berlin, Unter den Linden 77",
            "format": "jsonv2", "limit": 1, "key": KEY})
place = r.json()[0]
print(place["lat"], place["lon"])

JavaScript

const url = new URL("https://api.beegeo.ru/photon/api");
url.search = new URLSearchParams({
  q: "Alexanderplatz Berlin", limit: 5, key: KEY });
const res = await fetch(url);
const { features } = await res.json();
features.forEach(f => console.log(
  f.properties.name, f.geometry.coordinates));

Rules

Tools

Free online tools — no key needed

Free

Get an API key in a minute

Sign up with email or Telegram — your key appears instantly. Up to three keys per account, usage stats in the dashboard.

Sign up
Non-profit project

The service is free. If it helps you — support it

We accept USDT, Bitcoin, Ethereum and Solana. Donations pay for servers, disks and connectivity — keeping the geocoder fast and free for everyone.

Support the project

FAQ

Yes. It's a non-profit project: no fees for keys or requests, no ads in responses.

Yes, BeeGeo works as a free alternative: forward and reverse geocoding, address autocomplete and map tiles. You may store results and show them on any map, as long as you attribute OpenStreetMap.

Yes. /search, /reverse and /lookup mirror the Nominatim API, and /photon/api mirrors the Photon API. Just change the server URL and add your key. Autocomplete, which is not allowed on the public nominatim.openstreetmap.org, is done here with Photon.

The whole world: the full OpenStreetMap database, updated daily. Names and addresses come in the language you ask for via accept-language (en, de, fr, ru and more); if there's no translation, the local name is returned.

Yes. /overpass accepts Overpass QL queries against the full OpenStreetMap database, updated daily — an alternative to the overloaded public overpass-api.de servers.

Yes. Raster PNG for Leaflet and OpenLayers (256 and 512 px, retina), vector tiles and a ready-made MapLibre GL style — with the same key as the geocoder. Limit: 50 tiles per second per key.

Use the backup endpoint https://api2.beegeo.ru — it accepts the same keys and requests. During maintenance on the main server we point the backup to a mirror. We recommend configuring it as a fallback in your code: on a connection error, retry against api2.

Nominatim — 1 request per second per key. Overpass — 1 concurrent request per key, up to 60 s timeout. Tiles — 50 per second. Daily per key: Nominatim 50,000, Photon 500,000, Overpass 2,000, tiles 1,000,000 requests. Photon autocomplete has no hard rate limit, but keys are blocked for abuse.