Place search

Place names to coordinates.

Resolve a named place or public address into coordinates, address fields, categories, and canonical map links through one GET request.

Request

curl --get 'https://extractor.sh/api/places' \
  --data-urlencode 'q=Brandenburg Gate Berlin' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'format=json'

Parameter	Required	Description
`q`	Yes	A place name or address with up to 200 characters. Include a city or country when useful.
`limit`	No	An integer from `1` to `10`. Default: `5`.
`language`	No	Canonical BCP 47 language tag. Default: `en`.
`country`	No	Optional two-letter ISO country hard filter.
`lat` + `lon`	No	Optional paired coordinates used as a location bias.
`type`	No	`any`, `house`, `street`, `locality`, `city`, `county`, `state`, `country`, or `other`.
`format`	No	`json` or `markdown`. Default: `json`.

Response

JSON returns a schema-v1 place-search feed. Items use the existing document entity and can include coordinates, a bounding box, category, country code, and structured street, house number, postal code, locality, region, and country fields.

{
  "schemaVersion": 1,
  "type": "feed",
  "source": "place-search",
  "attributes": {
    "feedType": "place-search",
    "query": "Brandenburg Gate Berlin",
    "language": "en",
    "placeType": "any",
    "resultCount": 1,
    "attribution": "© OpenStreetMap contributors"
  },
  "items": [
    {
      "type": "document",
      "title": "Brandenburg Gate",
      "attributes": {
        "latitude": 52.5163,
        "longitude": 13.3777,
        "address": "Pariser Platz 1, 10117 Berlin, Germany"
      }
    }
  ]
}

Boundaries

This is submitted place and address lookup, not autocomplete.
Reverse geocoding and caller-provided bounding boxes are not supported.
It does not return Google Maps ratings, reviews, photos, traffic, routes, or popularity data.
Broad category requests such as “every café near me” are not guaranteed; use a specific name and location.
Results contain OpenStreetMap data and retain its required attribution.
Successful searches may be cached for up to one hour.