Places API (Version 2)
The API is used to query places, points of interests and locations of different categories within a given filter. The API is implemented via HTTP Get request.
API URL
https://api.geoapify.com/v2/places
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 | |
| 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 |