GET ./places
Allows you to get all the Places in the Overture Maps Database. You can filter by Lat/Long, Brand, Country and Categories.
Query Parameters
Consult the Open API documentation for the full list of query parameters that can be used to filter the results. Here are some examples
By Latitude / Longitude / Radius
Query params:
lat, lng, radius
Example Request to GET all the 'categories=cafes' within 2000m of Bondi Beach:
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places?lat=-33.8910&lng=151.2769&radius=2000&categories=cafes'
Categories
e.g. categories=water_park - Comma separated string of Categories to filter
Example Request to GET all the Water Parks within 25km of Sydney
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=-33.8688' -d 'lng=151.2093' -d 'radius=25000' -d 'categories=water_park'
categories in September 2026Overture replaces the places categories property with basic_category + taxonomy upstream in September 2026. Nothing breaks in this API: the categories response field and filter are staying (derived from the taxonomy once the upstream column is gone), and the categories filter already matches values from both vocabularies. Note the values inside categories will shift to the new taxonomy vocabulary at that point. If you match on specific category strings, we recommend the taxonomy filter below.
Taxonomy (hierarchy-aware)
taxonomy — comma-separated Overture taxonomy categories. Matches the primary category or any ancestor in the taxonomy hierarchy, so one value covers every descendant: taxonomy=food_and_drink matches every restaurant, café, bar and bakery.
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=40.7128' -d 'lng=-74.0060' -d 'radius=1500' -d 'taxonomy=food_and_drink'
Every place also returns its full taxonomy in the response:
"taxonomy": {
"primary": "coffee_shop",
"hierarchy": ["food_and_drink", "non_alcoholic_beverage_venue", "coffee_shop"],
"alternates": []
},
"basic_category": "coffee_shop"
Operating Status
operating_status — filter by operating status, e.g. open or permanently_closed. Places without signals have a null status and are excluded when this filter is used. The field is also present on every place response.
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=51.5074' -d 'lng=-0.1278' -d 'radius=1000' -d 'operating_status=open'
Brand Details (logos, websites) via Wikidata
enrichment_fields=brand — adds an ext_brand object to branded places with the brand's logo URL, official website, industry and parent organisation, sourced from Wikidata (CC0):
"ext_brand": {
"label": "Bank of America",
"logo_url": "http://commons.wikimedia.org/wiki/Special:FilePath/Bank%20of%20America%20logo.svg",
"website": "https://www.bankofamerica.com/",
"industry": "financial sector"
}
Logo URLs are Wikimedia Commons links — append ?width=200 for a resized image. Present where Overture links the place's brand to a Wikidata QID (~1.5M places across ~3,000 chains).
Contact details (websites, phones, emails, socials)
Every place returns its contact details by default — no special parameter is required:
"websites": ["https://www.example-cafe.co.uk"],
"phones": ["+441234567890"],
"emails": ["hello@example-cafe.co.uk"],
"socials": ["https://www.facebook.com/examplecafe"]
You do not need enrichment_fields for websites or phones. enrichment_fields=brand is only for the Wikidata brand layer (logos, industry, parent). The four contact arrays above are always in the response when Overture has them.
Coverage varies by country and category. In well-mapped markets, websites and phones are populated for the large majority of businesses; emails and socials are sparser.
Filter to places that have contact details — has_contact
has_contact returns only places that already have at least one of the listed contact fields. It's comma-separated and matched with OR, which is ideal when you only want businesses you can actually reach or verify:
# only places with a website
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=51.5074' -d 'lng=-0.1278' -d 'radius=2000' -d 'categories=restaurant' -d 'has_contact=website'
# places with a website OR a social link (catches businesses that use a Facebook page instead of a site)
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=51.5074' -d 'lng=-0.1278' -d 'radius=2000' -d 'categories=restaurant' -d 'has_contact=website,social'
Allowed values: website, phone, email, social. The Pagination-Count header reflects the filtered total, so you can see how many places match before paging through them.
Brands / Retail Chain
e.g. brand_name=H&M - The name of the Brand to filter by e.g. Uniqlo, McDonalds
Example Request to GET Uniqlo stores within 10km of New York City
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=40.7128' -d 'lng=-74.0060' -d 'radius=10000' -d 'brand_name=Uniqlo'
Example of a response for a 7-Eleven store near New York City:
curl -H "x-api-key: DEMO-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'lat=40.7128' -d 'lng=-74.0060' -d 'radius=10000' -d 'limit=1' -d 'brand_name=7-Eleven'
By Country
e.g. ?country=US - The ISO 3166-1 alpha-2 country code to filter by. e.g. US, GB, FR (UK is GB). Country-level queries need your own API key (the demo key is limited to nearby lat/lng search) and must include a narrowing filter such as categories, taxonomy or brand_name.
Example Request to GET 10 restaurants in the US (with your own key):
curl -H "x-api-key: YOUR-API-KEY" -X GET -G 'https://api.overturemapsapi.com/places' \
-d 'country=US' -d 'categories=restaurant' -d 'limit=10'
Pagination
limit (page size) + page (0-indexed). Totals come back in the Pagination-Count / Pagination-Page / Pagination-Limit response headers.
Enriched Responses
e.g. Conflating with the OpenStreetMap equivalent