Tools/maps/search_places

maps/search_places

Find places and points of interest of a category near a location.

0.1 credits / call ($0.0001)
charged on success

What it does

Returns places and points of interest (cafes, restaurants, shops, hotels, etc.) of one or more categories within an area, with names, addresses, coordinates, and details.

Primary use cases

  • Listing places of a type near a point (all cafes nearby).
  • Building "what's around here" experiences.

Good to know

categories is comma-separated Geoapify category IDs, e.g. catering.cafe, catering.restaurant, commercial.supermarket, accommodation.hotel, leisure.park. Bound the search with filter (e.g. "circle:lon,lat,meters" or "rect:lon1,lat1,lon2,lat2") and rank with bias (e.g. "proximity:lon,lat"). Resolve a location to coordinates with geocode first.

Parameters

biasstringoptional

Rank results toward a location, e.g. "proximity:lon,lat".

langstringoptional

2-letter language code for result names (e.g. "en").

limitintegeroptionaldefault: 20

Number of results (1-100).

filterstringoptional

Area to search within, e.g. "circle:lon,lat,meters" or "rect:lon1,lat1,lon2,lat2".

categoriesstringrequired

Comma-separated category IDs, e.g. "catering.cafe,catering.restaurant", "commercial.supermarket", "accommodation.hotel".

maps/search_places — Faro