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