Places API

The Places API is designed to help you discover points of interest and local amenities. You can query places within a certain radius of a point, within a reachability area or isoline, and by bounding box.

The Places API lets you query places by category, like accommodations, shops, parking, and more. We’ve also created conditions, which allow you to apply additional filters, such as free access, wi-fi available, and suitable with wheelchairs.

Play with Places API in the API Playground:

• Authentication and Geocoding API key
• API reference
• Supported categories
• Supported conditions
• Pricing

Authentication and API key

To use the API, you'll need an API key. But don't worry! You can register and get a Places API key for free without a credit card. Our free plan includes up to 3000 requests/day. For more information on our plans, visit the Pricing page.

How to get Places API key

1. Register on Geoapify MyProjects page
2. Create a new project.
3. Go to the API Keys section. One API key is generated automatically. You can generate multiple API keys per project if required.
4. Optionally, you can protect the API key by listing allowed IP addresses, HTTP referrers, origins, and CORS.
5. Choose "Places API" and an API key to get an URL and programming code.
6. Press the "Try" button to execute the API call and get the result object.

API reference

You can use the Places API to query places, points of interest, and locations of different categories.

This API is accessed through HTTP Get requests.

API URL

https://api.geoapify.com/v2/places?PARAMS

Request parameters

Filters

The API allows to set the following types of filters for results:

Bias

Response Object

The response returned contains a GeoJSON FeatureCollection object, where each feature has a "Point" type. Feature properties have the following fields:

Supported categories

The categories are hierarchical, use detailed key to more detailed queries or a parent category for more common queries.

For example:

• you can query only motels by using the "accommodation.motel" key.

• you can use the "accommodation" key to get all object related to subcategories - "accommodation.hut |accommodation.apartment |accommodation.chalet" and others.

We constantly enhance the list of the categories. Contact us at [email protected], if a required category is missing in the list.

Supported conditions

The same as categories the conditions are hierarchical, use detailed key to more detailed queries or a parent category for more common queries.

URL examples

Here are examples of URLs that show how to use the input parameters of the Places API

Search places by multiple categories

You can search by multiple categories at the same time. For example, the request below will return restaurants and cafes in Munich's historical center:

https://api.geoapify.com/v2/places?categories=catering.restaurant,catering.cafe&filter=rect:11.573106549898483,48.13898913611139,11.57704581350751,48.13666585409989&limit=20&apiKey=YOUR_API_KEY

Search places with conditions

Conditions let you narrow your search results by adding additional requirements to the places. For example, you can search for restaurants that serve vegetarian food near Central Park, New York:

https://api.geoapify.com/v2/places?categories=catering.restaurant&conditions=vegetarian&filter=rect:-73.99331143343392,40.77129742280923,-73.97215311088917,40.757134681430635&limit=20&apiKey=YOUR_API_KEY

Search places within a visible area

You can search places near a visible area using bounding boxes. Here is an example of searching museums in Paris near Île de la Cité:

https://api.geoapify.com/v2/places?categories=entertainment.museum&filter=rect:2.3380862086841603,48.861868995221684,2.357539944586165,48.850557094041235&limit=20&apiKey=YOUR_API_KEY

Search places within a city district

You can search places within a particular district, city, or postcode boundary. Here is an example of searching theatres and other cultural objects in Caluire-et-Cuire, France:

https://api.geoapify.com/v2/places?categories=entertainment.culture&filter=place:51a1f4444906681340595f4499441ae64640f00101f9017162010000000000c0020692031043616c756972652d65742d4375697265&limit=20&apiKey=YOUR_API_KEY

Search places near a location with a radius filter

You can also use a circle to get places near a location. For example, this request searches underground stations within 1000 meters of a location in London:

https://api.geoapify.com/v2/places?categories=public_transport.subway&filter=circle:-0.07071648508463113,51.50848194136378,1000&bias=proximity:-0.07071648508463113,51.50848194136378&limit=20&apiKey=YOUR_API_KEY

The bias parameter lets to sort results by distance to the given location.

Search places nearest to a location places

Using a bias parameter without the filter parameter allows you to get a specified number of places sorted by distance to a provided location:

https://api.geoapify.com/v2/places?categories=public_transport.subway&bias=proximity:-0.07071648508463113,51.50848194136378&limit=20&apiKey=YOUR_API_KEY

Get a large number of places using the offset parameter

The maximum number of places you can request is 500. Use the offset parameter to retrieve more places.

For example, the request below returns 500 supermarkets in Vienna:

https://api.geoapify.com/v2/places?categories=commercial.supermarket&filter=rect:16.17903071551638,48.28499347053008,16.556767855560192,48.0623697740825&limit=500&apiKey=YOUR_API_KEY

Add offset=500 parameter to get a further 500 supermarkets:

https://api.geoapify.com/v2/places?categories=commercial.supermarket&filter=rect:16.17903071551638,48.28499347053008,16.556767855560192,48.0623697740825&limit=500&offset=500&apiKey=YOUR_API_KEY

Pricing

To calculate the cost of Geoapify API requests, we use credits. Credits allow us to simplify our pricing structure and give you an estimate of the API's complexity.

We offer a variety of Pricing Plans to meet your needs, each with a certain number of credits. Start with our FREE plan, which includes 3,000 credits per day. You can upgrade at any time if your usage exceeds the free quota.

The Places API call cost depends on the number of results - every 20 places cost 1 credit. Use the limit parameter to control the number of results.

For example, 125 places returned as a result cost 6 credits.