Places API

The Places API is a powerful tool that enables you to query local points of interest and amenities effortlessly. You can easily search for places in a city, within a specified radius of a point, within a reachability area or isoline, or even within a bounding box.

The Places API lets you conveniently query places by category, including accommodations, shops, parking, and much more. We've also included customizable conditions that allow you to apply additional filters, such as free access, availability of Wi-Fi, and wheelchair accessibility.

To experience the full capabilities of the Places API, we invite you to try it out in the API Playground. Play around with the different features and see how easy it is to find the necessary information.

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

Authentication and API key

You'll need an API key to use the Places API. However, obtaining one is quick, easy, and free of charge, and you don't even need a credit card to get started! Our free plan includes up to 3000 requests per day, making it an excellent option for developers who want to test out our service. For more information on our different pricing plans, we recommend visiting our Pricing page to find the best option for your needs.

How to get Places API key

To get your Places API key, follow these steps:

1. Register on the Geoapify MyProjects page.
2. Create a new project.
3. Go to the API Keys section, where one API key is generated automatically. You can generate multiple API keys per project if needed.

You can also protect your API key by listing allowed IP addresses, HTTP referrers, origins, and CORS for added security.

Moreover, you can generate a code to call the API. Choose "Places API" and select an API key to receive a URL and programming code. Press the "Try" button to execute the API call and receive the result object.

API reference

The Places API is a versatile tool that enables you to retrieve information on various locations, points of interest, and places belonging to different categories.

To use the Places API, you'll need to make HTTP GET requests. These requests allow you to retrieve data related to your queries and integrate it into your application or service.

API URL

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

Request parameters

In an API parameters table, you'll find a comprehensive list of all the available parameters and their corresponding values and descriptions:

Filters

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

Bias

Response Object

The Place API response contains a GeoJSON FeatureCollection object. Each feature in this object has a "Point" type and represents a specific location or point of interest.

In addition to the location data, each feature contains properties that provide additional information about the location. These properties can include names, addresses, categories, and more. By accessing these properties, you can extract the most relevant information to your application and use it to enhance the user experience.

Supported categories

The Places API uses a hierarchical category system to allow you to specify the type of locations you want to retrieve. By using more specific category keys, you can narrow down your results to a specific type of location, while more general category keys will return a broader range of results.

For example, if you want to retrieve only motels, you can use the "accommodation.motel" key. If you want to retrieve all types of accommodations, including subcategories such as "accommodation.hut", "accommodation.apartment", and "accommodation.chalet", you can use the "accommodation" key.

Our list of categories is constantly expanding and evolving. If you cannot find a required category in the current list, please contact us at [email protected] and we will be happy to assist you in finding the category you need.

Supported conditions

Conditions refer to the specific attributes or characteristics of a place, such as its opening hours, wheelchair accessibility, or whether it has free Wi-Fi. These conditions can be used as filters in API requests to retrieve places that meet certain criteria.

Similar to the category hierarchy, the conditions in Places API are also hierarchical. For more specific queries, use detailed keys, while for broader queries, use parent conditions.

URL examples

The following examples demonstrate how to use input parameters in the Places API, by showing sample URLs with different query parameters.

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

Geoapify's API requests are priced in credits, simplifying our pricing structure and allowing us to estimate API usage's complexity.

We offer various Pricing Plans to suit different needs, each providing a certain number of credits. You can start with our FREE plan, which offers 3,000 credits per day, and upgrade at any time if you exceed this quota.

The cost of a Places API call depends on the number of results retrieved, with every 20 places costing 1 credit. You can control the number of results using the limit parameter.

For example, if you retrieve 115 places, the cost would be 6 credits.