fshy

Home / Data APIs

Nominatim (OpenStreetMap Foundation public instance)

operations.osmfoundation.org/policies/nominatim/Geocoding APIdata-apis/nominatimJSONcomparereport an errorprovider JSON

Free allowance
No request count and no key: an absolute maximum of 1 request per second per application, summed over all its users; a script running longer than a day or at regular intervals is held to 4 requests per minute, from a single thread on one machine
Verdict
caveatusable, with a named limit or an unprobed read path
Cost
free tier
Identity
anonymousno card, no phone
Binding limit
request-rate1 request per second at most, summed over every user of an application; 4 requests per minute for a script that runs longer than a day or at regular intervals; one thread on one machine
Evidence
documented18 sources; a first-party page was read and the sentence quoted
Freshness
stale on 2026-12-01checked 2026-10-31 (live); stale on 2026-12-01
Free tierno request count and no key: an absolute maximum of 1 request per second per application, summed over all its users; a script running longer than a day or at regular intervals is held to 4 requests per minute, from a single thread on one machine
unit requests; metered on none; a rate ceiling, not a metered quota; the service runs on donated servers with a very limited capacity, and the policy may change without notice
Pricenone stated
Limits
  • request-rate (binding) 1 request per second at most, summed over every user of an application source
  • request-rate (binding) 4 requests per minute for a script that runs longer than a day or at regular intervals; one thread on one machine source
  • per-object-cap at most 40 results for one search source
auto-complete search, systematic queries (reverse queries in a grid, complete lists of postcodes or towns, all POIs in an area) and scraping of the details page are banned outright
Bindingrequest-rate there is no counted quota, so the 1 request per second ceiling, and 4 per minute for a long-running script, is the whole capacity
Identityanonymous no account and no key; each request carries a valid HTTP Referer or a User-Agent that identifies the application, since stock library User-Agents are refused by the policy
Egressnot applicable: a query API, not metered in bytes
Per-object capone query per request, returning at most 40 results
Interfacerest HTTPS GET to nominatim.openstreetmap.org/search (and /reverse, /lookup) with format=json, jsonv2, geojson, geocodejson or xml; no key; a valid HTTP Referer or an application User-Agent is required; without a format parameter the public instance answers with the web page
Toolingany HTTP client that sets an identifying User-Agent or Referer; the policy asks apps to go through a caching proxy
Composes witha keyless geocoder for low-volume, user-triggered lookups at 1 request a second; a stored data set of more than a few thousand addresses goes to a keyed provider with storable results (data-apis/geoapify, data-apis/opencage, data-apis/maptiler). Bulk path: no bulk geocoding (systematic queries are banned); the raw data is the weekly OSM planet file (89 GB PBF) or a regional extract. The last resort is self-hosted: the Nominatim software, which the user installs and runs on a rented machine with an imported planet or extract
Reliabilitya requester that sends the same query repeatedly may be classed as faulty and blocked, a banned use (auto-complete, systematic queries, scraping of the details page) leads to a ban, and access can be withdrawn when the definition of heavy use changes
NotesThe hosted public instance of the Nominatim software. Bulk path: no bulk geocoding on the public instance; the raw data is the weekly OSM planet file or an extract.
Evidence notedocumented the rate ceiling is documented and was not exercised.
Parsed numbers
  • has-free-tier 1
  • request-rate 1 request
  • request-rate 4 requests / minute
Evidence 18
datesourcewhat it proved
2026-10-30operations.osmfoundation.org/policies/nominatim/the public instance allows at most 1 request per second
2026-10-30operations.osmfoundation.org/policies/nominatim/a valid Referer or an identifying User-Agent is required
2026-10-30operations.osmfoundation.org/policies/nominatim/the limit applies per application, summed over its users
2026-10-30operations.osmfoundation.org/policies/nominatim/long-running or periodic scripts are held to 4 requests per minute
2026-10-30operations.osmfoundation.org/policies/nominatim/bulk requests are limited to a single thread
2026-10-30operations.osmfoundation.org/policies/nominatim/bulk results must be cached, and repeated identical queries can be blocked
2026-10-30operations.osmfoundation.org/policies/nominatim/systematic queries are banned and complete data sets come from the planet file
2026-10-30operations.osmfoundation.org/policies/nominatim/auto-complete search on the public instance is banned
2026-10-30operations.osmfoundation.org/policies/nominatim/part of the text of Reliability, above
2026-10-30operations.osmfoundation.org/policies/nominatim/the service runs on donated servers with very limited capacity
2026-10-30nominatim.org/release-docs/latest/api/Search/one search returns at most 40 results
2026-10-30nominatim.org/release-docs/latest/api/Search/the output formats offered
2026-10-30www.openstreetmap.org/copyrightnot published
2026-10-30planet.openstreetmap.org/the weekly planet PBF file is 89 GB
2026-10-30planet.openstreetmap.org/a complete copy of OSM data is published every week
2026-10-30nominatim.org/release-docs/latest/admin/Installation/the Nominatim software can be installed by the user; a full planet import takes days
2026-10-30probe: https://nominatim.openstreetmap.org/search?q=Zurichan anonymous search with no key answered HTTP 200
2026-10-30probe: https://nominatim.openstreetmap.org/searchthe anonymous answer is a real geocode with coordinates
More fields 1
bulk pathno bulk geocoding; raw OSM data from the weekly planet file (89 GB PBF) or regional extracts