Skip to main content
POST
/
api
/
osm
/
places
/
search
/osm/places/search
curl --request POST \
  --url https://api.anysite.io/api/osm/places/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "tag_key": "<string>",
  "count": 2,
  "timeout": 60,
  "tag_value": "cafe",
  "bbox": "48.85,2.29,48.87,2.31",
  "lat": 0,
  "lon": 0,
  "radius_m": 25000,
  "element_types": [
    "node",
    "way",
    "relation"
  ]
}
'
[
  {
    "element_type": "<string>",
    "id": 123,
    "@type": "OsmPoi",
    "latitude": 123,
    "longitude": 123,
    "name": "<string>",
    "tags": {},
    "source_url": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
tag_key
string
required

OSM tag key to match, e.g. amenity, shop, tourism, leisure, office, healthcare, historic

Minimum string length: 1
Examples:

"amenity"

"shop"

"tourism"

count
integer
required

Max number of results

Required range: x >= 1
timeout
integer
default:60

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 180
tag_value
string | null

OSM tag value to match (omit to match any object having the key). Popular amenity values: cafe, restaurant, bar, fast_food, pharmacy, hospital, bank, atm, fuel, parking, school, place_of_worship

Example:

"cafe"

bbox
string | null

Bounding box as 'south,west,north,east' (decimal degrees)

Example:

"48.85,2.29,48.87,2.31"

lat
number | null

Center latitude for a radius search

Required range: -90 <= x <= 90
lon
number | null

Center longitude for a radius search

Required range: -180 <= x <= 180
radius_m
integer | null

Search radius in meters around the center point

Required range: 1 <= x <= 50000
element_types
enum<string>[]

Which OSM element types to search

Available options:
node,
way,
relation

Response

Successful Response

element_type
string
required
id
integer
required
@type
string
default:OsmPoi
latitude
number | null
longitude
number | null
name
string | null
tags
object
source_url
string | null