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:
- Authenfication and Geocoding API key
- API reference
- Supported categories
- Supported conditions
- Pricing
Learn more
Authenfication 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
- Register on Geoapify MyProjects page
- Create a new project.
- Go to the API Keys section. One API key is generated automatically. You can generate multiple API keys per project if required.
- Optionally, you can protect the API key by listing allowed IP addresses, HTTP referrers, origins, and CORS.
- Choose "Places API" and an API key to get an URL and programming code.
- 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
| Name | Description |
|---|---|
| categories | Comma-separated list of place categories. Check the supported values here. |
| conditions | In addition to categories, there is a possibility to filter results by conditions. For example, only places with internet_access. Check the supported values here. |
| filter | Filter places by bounds, circle, geometry or countries. |
| bias | Search first near the location. Note, the API will search places near the location, but not further tham 50km. |
| limit | Maximal number of results per page. |
| offset | Offset to the first result index. Is used to access pages, when number of results is bigger than given limit. |
| lang | Result language. 2-character ISO 639-1 language codes are supported. |
| name | Allows to filter places by the given name |
| apiKey | Required parameter for API key |
Filters
The API allows to set the following types of filters for results:
| Name | Format | Description | Examples |
|---|---|---|---|
| By circle | circle:lon,lat,radiusMeters |
Search places inside of the circle | filter=circle:-87.770231,41.878968,5000 |
| By rectangle | rect:lon1,lat1,lon2,lat2 |
Search places inside of the rectangle | filter=rect:-89.097540,39.668983,-88.399274,40.383412 |
| By geometry | geometry:geometryId |
Search places inside generated before geometry. For example, by isoline. | filter=geometry:d3046cf911d4d8bb8dd99394ef0921fb |
| By country [coming soon] | Comma-separated ISO 3166-1 Alpha-2 country codes (in lower case). Use 'auto' to detect the country by IP address. Use 'none' to skip (default value). | Search places in the countries. | filter=countrycode:de,es,fr |
Bias
| Name | Format | Description | Examples |
|---|---|---|---|
| By location | bias=proximity:lon,lat |
Prioritize results by farness from the location | bias=proximity:41.2257145,52.971411 |
Response Object
The response returned contains a GeoJSON FeatureCollection object, where each feature has a "Point" type. Feature properties have the following fields:
| Name | Description |
|---|---|
| name | Location name |
| country | Country component of an address |
| state | State component of an address |
| postcode | Postcode or ZIP code of an address |
| city | City component of an address |
| street | Street component of an address |
| housenumber | House number component of an address |
| lat, lon | Coordinates of the location |
| formatted | Display address |
| address_line1 | Main part of the display address, contains building street and house number or amenity name |
| address_line2 | The second part of the display address, contains address parts not included to address_line1 |
| categories | All categories, that the places belongs to. Can take values of supported categories and supported conditions |
| distance | Distance in meters to the bios location provided |
| place_id | Unique identifier for the place, that can be used to extract additional information about the place with Place Details API |
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.
| Key | Description |
|---|---|
| accommodation | Place to stay or live |
| accommodation.hotel | |
| accommodation.hut | |
| accommodation.apartment | |
| accommodation.chalet | |
| accommodation.guest_house | |
| accommodation.hostel | |
| accommodation.motel | |
| activity | Clubs, community centers |
| activity.community_center | |
| activity.sport_club | |
| commercial | Places where one can buy or sell things |
| commercial.supermarket | |
| commercial.marketplace | |
| commercial.shopping_mall | |
| commercial.department_store | |
| commercial.elektronics | |
| commercial.outdoor_and_sport | |
| commercial.outdoor_and_sport.water_sports | |
| commercial.outdoor_and_sport.ski | |
| commercial.outdoor_and_sport.diving | |
| commercial.outdoor_and_sport.hunting | |
| commercial.outdoor_and_sport.bicycle | |
| commercial.outdoor_and_sport.fishing | |
| commercial.outdoor_and_sport.golf | |
| commercial.vehicle | |
| commercial.hobby | |
| commercial.hobby.model | |
| commercial.hobby.anime | |
| commercial.hobby.collecting | |
| commercial.hobby.games | |
| commercial.hobby.brewing | |
| commercial.hobby.photo | |
| commercial.hobby.music | |
| commercial.hobby.sewing_and_knitting | |
| commercial.hobby.art | |
| commercial.books | |
| commercial.gift_and_souvenir | |
| commercial.stationery | |
| commercial.newsagent | |
| commercial.tickets_and_lottery | |
| commercial.clothing | |
| commercial.clothing.shoes | |
| commercial.clothing.clothes | |
| commercial.clothing.underwear | |
| commercial.clothing.sport | |
| commercial.clothing.men | |
| commercial.clothing.women | |
| commercial.clothing.kids | |
| commercial.clothing.accessories | |
| commercial.bag | |
| commercial.baby_goods | |
| commercial.agrarian | |
| commercial.garden | |
| commercial.houseware_and_hardware | |
| commercial.houseware_and_hardware.doityourself | |
| commercial.houseware_and_hardware.hardware_and_tools | |
| commercial.houseware_and_hardware.building_materials | |
| commercial.houseware_and_hardware.building_materials.paint | |
| commercial.houseware_and_hardware.building_materials.glaziery | |
| commercial.houseware_and_hardware.building_materials.doors | |
| commercial.houseware_and_hardware.building_materials.tiles | |
| commercial.houseware_and_hardware.building_materials.windows | |
| commercial.houseware_and_hardware.building_materials.flooring | |
| commercial.houseware_and_hardware.fireplace | |
| commercial.houseware_and_hardware.swimming_pool | |
| commercial.florist | |
| commercial.furniture_and_interior | |
| commercial.furniture_and_interior.lighting | |
| commercial.furniture_and_interior.curtain | |
| commercial.furniture_and_interior.carpet | |
| commercial.furniture_and_interior.kitchen | |
| commercial.furniture_and_interior.bed | |
| commercial.furniture_and_interior.bathroom | |
| commercial.chemist | |
| commercial.health_and_beauty | |
| commercial.health_and_beauty.pharmacy | |
| commercial.health_and_beauty.optician | |
| commercial.health_and_beauty.medical_supply | |
| commercial.health_and_beauty.hearing_aids | |
| commercial.health_and_beauty.herbalist | |
| commercial.health_and_beauty.cosmetics | |
| commercial.health_and_beauty.wigs | |
| commercial.toy_and_game | |
| commercial.pet | |
| commercial.food_and_drink | |
| commercial.food_and_drink.bakery | |
| commercial.food_and_drink.deli | |
| commercial.food_and_drink.frozen_food | |
| commercial.food_and_drink.pasta | |
| commercial.food_and_drink.spices | |
| commercial.food_and_drink.organic | |
| commercial.food_and_drink.honey | |
| commercial.food_and_drink.rice | |
| commercial.food_and_drink.nuts | |
| commercial.food_and_drink.health_food | |
| commercial.food_and_drink.ice_cream | |
| commercial.food_and_drink.seafood | |
| commercial.food_and_drink.fruit_and_vegetable | |
| commercial.food_and_drink.farm | |
| commercial.food_and_drink.confectionery | |
| commercial.food_and_drink.chocolate | |
| commercial.food_and_drink.butcher | |
| commercial.food_and_drink.cheese_and_dairy | |
| commercial.food_and_drink.drinks | |
| commercial.food_and_drink.coffee_and_tea | |
| commercial.convenience | |
| commercial.discount_store | |
| commercial.smoking | |
| commercial.second_hand | |
| commercial.gas | |
| commercial.weapons | |
| commercial.pyrotechnics | |
| commercial.energy | |
| commercial.wedding | |
| commercial.jewelry | |
| commercial.watches | |
| commercial.art | |
| commercial.antiques | |
| commercial.video_and_music | |
| commercial.erotic | |
| commercial.trade | |
| commercial.kiosk | |
| catering | Places of public catering: restaurants, cafes, bars, etc. |
| catering.restaurant | |
| catering.restaurant.pizza | |
| catering.restaurant.burger | |
| catering.restaurant.regional | |
| catering.restaurant.italian | |
| catering.restaurant.chinese | |
| catering.restaurant.sandwich | |
| catering.restaurant.chicken | |
| catering.restaurant.mexican | |
| catering.restaurant.japanese | |
| catering.restaurant.american | |
| catering.restaurant.kebab | |
| catering.restaurant.indian | |
| catering.restaurant.asian | |
| catering.restaurant.sushi | |
| catering.restaurant.french | |
| catering.restaurant.german | |
| catering.restaurant.thai | |
| catering.restaurant.greek | |
| catering.restaurant.seafood | |
| catering.restaurant.fish_and_chips | |
| catering.restaurant.steak_house | |
| catering.restaurant.international | |
| catering.restaurant.tex-mex | |
| catering.restaurant.vietnamese | |
| catering.restaurant.turkish | |
| catering.restaurant.korean | |
| catering.restaurant.noodle | |
| catering.restaurant.barbecue | |
| catering.restaurant.spanish | |
| catering.restaurant.fish | |
| catering.restaurant.ramen | |
| catering.restaurant.mediterranean | |
| catering.restaurant.friture | |
| catering.restaurant.beef_bowl | |
| catering.restaurant.lebanese | |
| catering.restaurant.wings | |
| catering.restaurant.georgian | |
| catering.restaurant.tapas | |
| catering.restaurant.indonesian | |
| catering.restaurant.arab | |
| catering.restaurant.portuguese | |
| catering.restaurant.russian | |
| catering.restaurant.filipino | |
| catering.restaurant.african | |
| catering.restaurant.malaysian | |
| catering.restaurant.caribbean | |
| catering.restaurant.peruvian | |
| catering.restaurant.bavarian | |
| catering.restaurant.brazilian | |
| catering.restaurant.curry | |
| catering.restaurant.dumpling | |
| catering.restaurant.persian | |
| catering.restaurant.argentinian | |
| catering.restaurant.oriental | |
| catering.restaurant.balkan | |
| catering.restaurant.moroccan | |
| catering.restaurant.pita | |
| catering.restaurant.ethiopian | |
| catering.restaurant.taiwanese | |
| catering.restaurant.latin_american | |
| catering.restaurant.hawaiian | |
| catering.restaurant.irish | |
| catering.restaurant.austrian | |
| catering.restaurant.croatian | |
| catering.restaurant.danish | |
| catering.restaurant.tacos | |
| catering.restaurant.bolivian | |
| catering.restaurant.hungarian | |
| catering.restaurant.western | |
| catering.restaurant.european | |
| catering.restaurant.jamaican | |
| catering.restaurant.cuban | |
| catering.restaurant.soup | |
| catering.restaurant.uzbek | |
| catering.restaurant.nepalese | |
| catering.restaurant.czech | |
| catering.restaurant.syrian | |
| catering.restaurant.afghan | |
| catering.restaurant.malay | |
| catering.restaurant.chili | |
| catering.restaurant.belgian | |
| catering.restaurant.ukrainian | |
| catering.restaurant.swedish | |
| catering.restaurant.pakistani | |
| catering.fast_food | |
| catering.fast_food.pizza | |
| catering.fast_food.burger | |
| catering.fast_food.sandwich | |
| catering.fast_food.kebab | |
| catering.fast_food.fish_and_chips | |
| catering.fast_food.noodle | |
| catering.fast_food.ramen | |
| catering.fast_food.wings | |
| catering.fast_food.tapas | |
| catering.fast_food.pita | |
| catering.fast_food.tacos | |
| catering.fast_food.soup | |
| catering.fast_food.salad | |
| catering.fast_food.hot_dog | |
| catering.cafe | |
| catering.cafe.waffle | |
| catering.cafe.ice_cream | |
| catering.cafe.coffee_shop | |
| catering.cafe.donut | |
| catering.cafe.crepe | |
| catering.cafe.bubble_tea | |
| catering.cafe.cake | |
| catering.cafe.frozen_yogurt | |
| catering.cafe.dessert | |
| catering.cafe.coffee | |
| catering.cafe.tea | |
| catering.food_court | |
| catering.bar | |
| catering.pub | |
| catering.ice_cream | |
| catering.biergarten | |
| education | Place that provides learning spaces and learning environments |
| education.school | |
| education.driving_school | |
| education.music_school | |
| education.language_school | |
| education.library | |
| education.college | |
| education.university | |
| childcare | Place that provides care of children service while parents are working |
| childcare.kindergarten | |
| entertainment | Place that where one can spend free time with amusement |
| entertainment.culture | |
| entertainment.culture.theatre | |
| entertainment.culture.arts_centre | |
| entertainment.culture.gallery | |
| entertainment.zoo | |
| entertainment.aquarium | |
| entertainment.planetarium | |
| entertainment.museum | |
| entertainment.cinema | |
| entertainment.amusement_arcade | |
| entertainment.escape_game | |
| entertainment.miniature_golf | |
| entertainment.bowling_alley | |
| entertainment.flying_fox | |
| entertainment.theme_park | |
| entertainment.water_park | |
| healthcare | Places that provides healthcare services: hospitals, clinics and more |
| healthcare.clinic_or_praxis | |
| healthcare.clinic_or_praxis.allergology | |
| healthcare.clinic_or_praxis.vascular_surgery | |
| healthcare.clinic_or_praxis.urology | |
| healthcare.clinic_or_praxis.trauma | |
| healthcare.clinic_or_praxis.rheumatology | |
| healthcare.clinic_or_praxis.radiology | |
| healthcare.clinic_or_praxis.pulmonology | |
| healthcare.clinic_or_praxis.psychiatry | |
| healthcare.clinic_or_praxis.paediatrics | |
| healthcare.clinic_or_praxis.otolaryngology | |
| healthcare.clinic_or_praxis.orthopaedics | |
| healthcare.clinic_or_praxis.ophthalmology | |
| healthcare.clinic_or_praxis.occupational | |
| healthcare.clinic_or_praxis.gynaecology | |
| healthcare.clinic_or_praxis.general | |
| healthcare.clinic_or_praxis.gastroenterology | |
| healthcare.clinic_or_praxis.endocrinology | |
| healthcare.clinic_or_praxis.dermatology | |
| healthcare.clinic_or_praxis.cardiology | |
| healthcare.dentist | |
| healthcare.dentist.orthodontics | |
| healthcare.hospital | |
| healthcare.pharmacy | |
| heritage | |
| heritage.unesco | |
| leisure | Places where one can relax and unwind |
| leisure.picnic | |
| leisure.picnic.picnic_site | |
| leisure.picnic.picnic_table | |
| leisure.picnic.bbq | |
| leisure.playground | |
| leisure.spa | |
| leisure.spa.public_bath | |
| leisure.spa.sauna | |
| leisure.park | |
| leisure.park.garden | |
| leisure.park.nature_reserve | |
| man_made | The man-made category is used to identify anything that was constructed by humans |
| man_made.pier | |
| man_made.breakwater | |
| man_made.tower | |
| man_made.water_tower | |
| man_made.bridge | |
| man_made.lighthouse | |
| man_made.windmill | |
| man_made.watermill | |
| natural | Places where one can enjoy nature, explore natural phenomena |
| natural.forest | |
| natural.water | |
| natural.water.spring | |
| natural.water.reef | |
| natural.water.hot_spring | |
| natural.water.geyser | |
| natural.water.sea | |
| natural.mountain | |
| natural.mountain.peak | |
| natural.mountain.glacier | |
| natural.mountain.cliff | |
| natural.mountain.rock | |
| natural.mountain.cave_entrance | |
| natural.sand | |
| natural.sand.dune | |
| natural.protected_area | |
| national_park | National parks |
| parking | Places where one can park a car |
| parking.cars | |
| parking.cars.surface | |
| parking.cars.multistorey | |
| parking.cars.underground | |
| parking.cars.rooftop | |
| parking.surface | |
| parking.multistorey | |
| parking.underground | |
| parking.rooftop | |
| parking.motorcycle | |
| parking.bicycles | |
| pet | Places that can be interesting for pet owners |
| pet.shop | |
| pet.veterinary | |
| pet.service | |
| pet.dog_park | |
| rental | Places where one can rent things |
| rental.car | |
| rental.storage | |
| rental.bicycle | |
| rental.boat | |
| rental.ski | |
| service | Places that provide services to the public |
| service.financial | |
| service.financial.atm | |
| service.financial.payment_terminal | |
| service.financial.bank | |
| service.financial.bureau_de_change | |
| service.financial.money_transfer | |
| service.financial.money_lender | |
| service.cleaning | |
| service.cleaning.lavoir | |
| service.cleaning.laundry | |
| service.cleaning.dry_cleaning | |
| service.travel_agency | |
| service.post | |
| service.post.office | |
| service.post.box | |
| service.police | |
| service.vehicle | |
| service.vehicle.fuel | |
| service.vehicle.car_wash | |
| service.vehicle.charging_station | |
| service.vehicle.repair | |
| service.vehicle.repair.car | |
| service.vehicle.repair.motorcycle | |
| service.beauty | |
| service.beauty.hairdresser | |
| service.beauty.spa | |
| service.beauty.massage | |
| service.tailor | |
| service.funeral_directors | |
| service.bookmaker | |
| service.estate_agent | |
| service.locksmith | |
| service.taxi | |
| tourism | Places that can be interesting for tourists |
| tourism.information | |
| tourism.information.office | |
| tourism.information.map | |
| tourism.information.ranger_station | |
| tourism.attraction | |
| tourism.attraction.artwork | |
| tourism.attraction.viewpoint | |
| tourism.attraction.fountain | |
| tourism.attraction.clock | |
| tourism.sights | |
| tourism.sights.place_of_worship | |
| tourism.sights.place_of_worship.church | |
| tourism.sights.place_of_worship.chapel | |
| tourism.sights.place_of_worship.cathedral | |
| tourism.sights.place_of_worship.mosque | |
| tourism.sights.place_of_worship.synagogue | |
| tourism.sights.place_of_worship.temple | |
| tourism.sights.place_of_worship.shrine | |
| tourism.sights.monastery | |
| tourism.sights.city_hall | |
| tourism.sights.conference_centre | |
| tourism.sights.lighthouse | |
| tourism.sights.windmill | |
| tourism.sights.tower | |
| tourism.sights.battlefield | |
| tourism.sights.fort | |
| tourism.sights.castle | |
| tourism.sights.ruines | |
| tourism.sights.archaeological_site | |
| tourism.sights.city_gate | |
| tourism.sights.bridge | |
| tourism.sights.memorial | |
| tourism.sights.memorial.aircraft | |
| tourism.sights.memorial.locomotive | |
| tourism.sights.memorial.railway_car | |
| tourism.sights.memorial.ship | |
| tourism.sights.memorial.tank | |
| tourism.sights.memorial.tomb | |
| tourism.sights.memorial.monument | |
| tourism.sights.memorial.wayside_cross | |
| tourism.sights.memorial.boundary_stone | |
| tourism.sights.memorial.pillory | |
| tourism.sights.memorial.milestone" | |
| camping | Places that provide outdoor activity including overnight stay |
| camping.camp_pitch | |
| camping.camp_site | |
| camping.summer_camp | |
| camping.caravan_site | |
| amenity | Small amenities, that can be useful in different situations |
| amenity.toilet | |
| amenity.drinking_water | |
| beach | A shore of a body of water covered by sand, gravel, or larger rock fragments |
| beach.beach_resort | |
| adult | Places that provide entertainments for adults, sometimes with a sexual context |
| adult.nightclub | |
| adult.stripclub | |
| adult.swingerclub | |
| adult.brothel | |
| adult.casino | |
| adult.adult_gaming_centre | |
| airport | |
| airport.international | |
| building | Stand alone buildings and places |
| building.residential | |
| building.commercial | |
| building.industrial | |
| building.office | |
| building.catering | |
| building.healthcare | |
| building.university | |
| building.college | |
| building.dormitory | |
| building.school | |
| building.driving_school | |
| building.kindergarten | |
| building.public_and_civil | |
| building.sport | |
| building.spa | |
| building.place_of_worship | |
| building.holiday_house | |
| building.accommodation | |
| building.tourism | |
| building.transportation | |
| building.military | |
| building.service | |
| building.facility | |
| building.garage | |
| building.parking | |
| building.toilet | |
| building.prison | |
| building.entertainment | |
| building.historic | |
| ski | Infrastructure objects related to downhill skiing sport kinds |
| ski.lift | |
| ski.lift.cable_car | |
| ski.lift.gondola | |
| ski.lift.mixed_lift | |
| ski.lift.chair_lift | |
| ski.lift.tow_line | |
| ski.lift.magic_carpet | |
| sport | Infrastructure objects related to different sport kinds |
| sport.stadium | |
| sport.dive_centre | |
| sport.horse_riding | |
| sport.ice_rink | |
| sport.pitch | |
| sport.sports_centre | |
| sport.swimming_pool | |
| sport.track | |
| sport.fitness | |
| sport.fitness.fitness_centre | |
| sport.fitness.fitness_station | |
| public_transport | Public transport stations and stops |
| public_transport.train | |
| public_transport.light_rail | |
| public_transport.monorail | |
| public_transport.subway | |
| public_transport.subway.entrance | |
| public_transport.bus | |
| public_transport.tram | |
| public_transport.ferry | |
| public_transport.aerialway | |
| administrative | Administrative boundary |
| administrative.continent_level | |
| administrative.country_level | |
| administrative.country_part_level | |
| administrative.state_level | |
| administrative.county_level | |
| administrative.city_level | |
| administrative.district_level | |
| administrative.suburb_level | |
| administrative.neighbourhood_level | |
| postal_code | Postcode boundary |
| political | Political boundary |
| low_emission_zone | Low emission zone |
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.
| Key | Description |
|---|---|
| internet_access | Places that provide an internet access |
| internet_access.free | |
| internet_access.for_customers | |
| wheelchair | Places that are suitable to be used with wheelchairs |
| wheelchair.yes | |
| wheelchair.limited | |
| dogs | Places where dogs are allowed |
| dogs.yes | |
| dogs.leashed | |
| no-dogs | Places where dogs are not allowed |
| access | Places that are available for public |
| access.yes | The access is specified as public |
| access.not_specified | The access information is missing. The place is considered as public |
| access_limited | Places with limited access |
| access_limited.private | |
| access_limited.customers | |
| access_limited.with_permit | |
| access_limited.services | |
| no_access | Places that are not available for public |
| fee | There is a fee |
| no_fee | There is no fee or it's not specified |
| no_fee.no | |
| no_fee.not_specified | |
| named | Name property defined for the place |
| vegetarian | Places where you can buy or eat vegetarian food |
| vegetarian.only | Places that serve vegetarian food only |
| vegan | Places where you can buy or eat vegan food |
| vegan.only | Places that serve vegan food only |
| halal | Places where you can buy or eat halal food |
| halal.only | Places that serve halal food only |
| kosher | Places where you can buy or eat kosher food |
| kosher.only | Places that serve kosher food only |
| organic | Places where you can buy or eat organic food |
| organic.only | Places that serve organic food only |
| gluten_free | Places where you can buy or eat gluten free food |
| sugar_free | Places where you can buy or eat sugar free food |
| egg_free | Places where you can buy or eat egg free food |
| soy_free | Places where you can buy or eat soy free food |
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.
Learn more