Places search

GET /v1/places finds US businesses and points of interest (restaurants, shops, banks, clinics, parks and more) by name, by kind or near a point, and returns GeoJSON you can keep. It is on every plan, and each call counts 1 address lookup.

Try it without a key

curl "https://api.mapiron.com/v1/demo/places?q=coffee&near=30.2672,-97.7431"

The keyless demo returns up to 5 places and is limited per visitor. With a key, use /v1/places.

Search by name, near a point, or both

curl "https://api.mapiron.com/v1/places?q=coffee&near=30.2672,-97.7431&radius=2000&limit=5&key=YOUR_KEY"

curl "https://api.mapiron.com/v1/places?q=whole+foods+austin+tx&key=YOUR_KEY"

curl "https://api.mapiron.com/v1/places?near=30.2672,-97.7431&radius=500&category=restaurant&key=YOUR_KEY"

Pass at least q or near. A search that matches too many places to rank (one very common word with no location) answers 400 query_too_broad: add near, a town, state or ZIP code, or another word.

Response

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [-122.44711, 37.78066] },
      "properties": {
        "name": "Epiphany Center",
        "category": "specialized_medical_facility",
        "taxonomy": "abuse_and_addiction_treatment_center",
        "address": "100 Masonic Ave", "city": "San Francisco", "state": "CA", "postcode": "94118", "country": "US",
        "phone": "+14155678370", "website": "http://www.theepiphanycenter.org/",
        "operating_status": "open",
        "gers_id": "d90ef93b-7d52-4d92-be0a-7f5e2eb6011b",
        "confidence": 0.999,
        "source": "overture", "source_datasets": ["meta"], "source_license": ["CDLA-Permissive-2.0"],
        "overture_release": "2026-10-21.0",
        "precision": "place", "keep_forever": true, "distance_m": 12
      }
    }
  ],
  "attribution": "Places: Overture Maps Foundation (overturemaps.org) and its data sources. Sources and licences: https://mapiron.com/attributions#places",
  "license": "You may store these results. No share-alike terms: each place lists its licence in source_license ...",
  "licenses": [ { "id": "CDLA-Permissive-2.0", "name": "Community Data License Agreement - Permissive, Version 2.0", "url": "https://cdla.dev/permissive-2-0/" } ],
  "release": "2026-10-21.0",
  "data_version": "20261112"
}

Look a place up by its id

curl "https://api.mapiron.com/v1/places/d90ef93b-7d52-4d92-be0a-7f5e2eb6011b?key=YOUR_KEY"

Returns the same shape with one place, or 404 when the current release no longer has that id. An id stays the same from release to release while Overture can match the place; it can change when a place is renamed, moves or is merged with another listing. 1 address lookup.

Storing results and credit

• Paid plans may store places results indefinitely. Free may store them for up to 30 days. The license field of each answer says which applies.
• Show the attribution text near places you display. Places are not OpenStreetMap data, so they don't need the OpenStreetMap credit (your map still does).
• If you pass stored places on to others, keep the attribution and make the licence texts available: the links in licenses are enough. Foursquare-sourced places also carry Foursquare's copyright notice there.

A place from any provider or licence that isn't in this table is left out of our index until we have read its terms. Full list: Data sources and licences.

Coverage and limits

• United States only for now.
• Places data has duplicates and listings that are out of date. Treat confidence as a guide, and don't present a result as verified.
• Places search doesn't change /v1/geocode: geocoding answers still come only from OpenStreetMap and our address layer.
• Hard monthly caps apply as for geocoding: at the cap you get 429 monthly_cap_reached, and nothing is billed for overage.
• AI assistants can use the place_search tool on the MCP server.