POST
/
v1
/
places
/
nearby
Find Nearby Places
curl --request POST \
  --url https://api.milaapi.com/v1/places/nearby \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "latitude": 50.0755,
  "longitude": 14.4378,
  "categories": [
    "restaurant",
    "cafe"
  ],
  "radius": 1000,
  "limit": 10
}'
{
  "places": [
    {
      "id": "place_charles_bridge_001",
      "name_primary": "Charles Bridge",
      "primary_category": "bridge",
      "alternate_categories": [
        "tourist_attraction",
        "historical_site"
      ],
      "address_freeform": "Karlův most, 110 00 Praha 1",
      "formatted_address": "Karlův most, 110 00 Praha 1, Czech Republic",
      "phones": null,
      "websites": [
        "https://www.prague.eu/en/object/places/93/charles-bridge-karluv-most"
      ],
      "longitude": 14.4131,
      "latitude": 50.0865,
      "distance": 892.1
    },
    {
      "id": "place_lokál_dlouhááá_001",
      "name_primary": "Lokál Dlouhááá",
      "primary_category": "restaurant",
      "alternate_categories": [
        "pub",
        "czech_restaurant"
      ],
      "address_freeform": "Dlouhá 33, 110 00 Praha 1",
      "formatted_address": "Dlouhá 33, 110 00 Praha 1, Czech Republic",
      "phones": [
        "+420 222 316 265"
      ],
      "websites": [
        "https://lokal-dlouha.ambi.cz"
      ],
      "longitude": 14.4234,
      "latitude": 50.0898,
      "distance": 534.2
    }
  ],
  "total": 2
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Place nearby request model

longitude
number | null
Required range: -180 <= x <= 180
latitude
number | null
Required range: -90 <= x <= 90
categories
string[]
limit
integer | null
default:10
Required range: 1 <= x <= 100
radius
number | null
Required range: 100 <= x <= 1000000
ne
object | null

Lat/Lon model

sw
object | null

Lat/Lon model

Response

Successful Response

Place complete response model

places
PlaceResponse · object[]
required
total
integer
required