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.

Places API Live Demo



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

Request parameters

Use this checklist when building a request:

  • Required: always include your API key and at least one category.
  • Optional: language, bias, and paging controls tailor the response to your needs.
  • Filters & bias: choose one or combine them to focus the search area.

Core parameters

Name Required Description Example
apiKey Required API key for authentication apiKey=YOUR_API_KEY
categories Required Primary place categories. See supported categories. categories=commercial.supermarket
conditions Optional Additional filters such as accessibility or amenities. See supported conditions. conditions=wheelchair.yes
filter Optional Spatial filters that constrain the search area. See the table below. filter=rect:-89.1,39.66,-88.39,40.38
bias Optional Prioritises results near a location without excluding others. bias=proximity:-73.99,40.77
limit Optional Maximum number of results per page. limit=20
offset Optional Start index for pagination (use with limit). offset=40
lang Optional Response language as an ISO 639-1 code. lang=en
name Optional Returns places matching a given name. name=Starbucks

Add at least one spatial control—either a filter or a bias—so the API knows where to look for places.

Filters

Filter Format Description Example
Circle circle:lon,lat,radiusMeters Results inside a circle filter=circle:-87.770231,41.878968,5000
Rectangle rect:lon1,lat1,lon2,lat2 Results inside a bounding box filter=rect:-89.097540,39.668983,-88.399274,40.383412
Geometry geometry:geometryId Re-use a previously generated geometry (e.g. isoline) filter=geometry:d3046cf911d4d8bb8dd99394ef0921fb
Place place:placeId Boundary returned by Geoapify APIs (city, district, postcode, etc.) filter=place:51f07665660fc4024059dc0a96dfac6c...
Country (coming soon) countrycode:code1,code2 ISO 3166-1 alpha-2 country codes (auto detects by IP) filter=countrycode:de,es,fr

Bias

Bias Format Description Example
Proximity bias=proximity:lon,lat Orders results by distance from the location bias=proximity:41.2257145,52.971411

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.

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 biased location
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 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.

Use the sections below to explore categories grouped by their top-level key. Each table lists the values you can pass in the categories parameter.

Accommodation

Key Description
accommodation Place to stay or live
accommodation.apartment
accommodation.chalet
accommodation.guest_house
accommodation.hostel
accommodation.hotel
accommodation.hut
accommodation.motel

Activity

Key Description
activity Clubs, community centers
activity.community_center
activity.sport_club

Airport

Key Description
airport Facility for aircraft operations, including takeoffs, landings, and maintenance
airport.airfield Area for aircraft operations, can range from simple to complex facilities
airport.gliding Designed for glider operations, may include winches or tow planes
airport.international Handles international flights with customs and immigration facilities
airport.military Dedicated to armed forces use
airport.private Owned by individuals or entities, not open to the public, for private aviation

Commercial

Key Description
commercial Places where one can buy or sell things
commercial.agrarian
commercial.antiques
commercial.art
commercial.baby_goods
commercial.bag
commercial.books
commercial.chemist
commercial.clothing
commercial.clothing.accessories
commercial.clothing.clothes
commercial.clothing.kids
commercial.clothing.men
commercial.clothing.shoes
commercial.clothing.sport
commercial.clothing.underwear
commercial.clothing.women
commercial.convenience
commercial.department_store
commercial.discount_store
commercial.elektronics
commercial.energy
commercial.erotic
commercial.florist
commercial.food_and_drink
commercial.food_and_drink.bakery
commercial.food_and_drink.butcher
commercial.food_and_drink.cheese_and_dairy
commercial.food_and_drink.chocolate
commercial.food_and_drink.coffee_and_tea
commercial.food_and_drink.confectionery
commercial.food_and_drink.deli
commercial.food_and_drink.drinks
commercial.food_and_drink.farm
commercial.food_and_drink.frozen_food
commercial.food_and_drink.fruit_and_vegetable
commercial.food_and_drink.health_food
commercial.food_and_drink.honey
commercial.food_and_drink.ice_cream
commercial.food_and_drink.nuts
commercial.food_and_drink.organic
commercial.food_and_drink.pasta
commercial.food_and_drink.rice
commercial.food_and_drink.seafood
commercial.food_and_drink.spices
commercial.furniture_and_interior
commercial.furniture_and_interior.bathroom
commercial.furniture_and_interior.bed
commercial.furniture_and_interior.carpet
commercial.furniture_and_interior.curtain
commercial.furniture_and_interior.kitchen
commercial.furniture_and_interior.lighting
commercial.garden
commercial.gas
commercial.gift_and_souvenir
commercial.health_and_beauty
commercial.health_and_beauty.cosmetics
commercial.health_and_beauty.hearing_aids
commercial.health_and_beauty.herbalist
commercial.health_and_beauty.medical_supply
commercial.health_and_beauty.optician
commercial.health_and_beauty.pharmacy
commercial.health_and_beauty.wigs
commercial.hobby
commercial.hobby.anime
commercial.hobby.art
commercial.hobby.brewing
commercial.hobby.collecting
commercial.hobby.games
commercial.hobby.model
commercial.hobby.music
commercial.hobby.photo
commercial.hobby.sewing_and_knitting
commercial.houseware_and_hardware
commercial.houseware_and_hardware.building_materials
commercial.houseware_and_hardware.building_materials.doors
commercial.houseware_and_hardware.building_materials.flooring
commercial.houseware_and_hardware.building_materials.glaziery
commercial.houseware_and_hardware.building_materials.paint
commercial.houseware_and_hardware.building_materials.tiles
commercial.houseware_and_hardware.building_materials.windows
commercial.houseware_and_hardware.doityourself
commercial.houseware_and_hardware.fireplace
commercial.houseware_and_hardware.hardware_and_tools
commercial.houseware_and_hardware.swimming_pool
commercial.jewelry
commercial.kiosk
commercial.marketplace
commercial.newsagent
commercial.outdoor_and_sport
commercial.outdoor_and_sport.bicycle
commercial.outdoor_and_sport.diving
commercial.outdoor_and_sport.fishing
commercial.outdoor_and_sport.golf
commercial.outdoor_and_sport.hunting
commercial.outdoor_and_sport.ski
commercial.outdoor_and_sport.water_sports
commercial.pet
commercial.pyrotechnics
commercial.second_hand
commercial.shopping_mall
commercial.smoking
commercial.stationery
commercial.supermarket
commercial.tickets_and_lottery
commercial.toy_and_game
commercial.trade
commercial.vehicle
commercial.video_and_music
commercial.watches
commercial.weapons
commercial.wedding

Catering

Key Description
catering Places of public catering: restaurants, cafes, bars, etc.
catering.bar
catering.biergarten
catering.cafe
catering.cafe.bubble_tea
catering.cafe.cake
catering.cafe.coffee
catering.cafe.coffee_shop
catering.cafe.crepe
catering.cafe.dessert
catering.cafe.donut
catering.cafe.frozen_yogurt
catering.cafe.ice_cream
catering.cafe.tea
catering.cafe.waffle
catering.fast_food
catering.fast_food.burger
catering.fast_food.fish_and_chips
catering.fast_food.hot_dog
catering.fast_food.kebab
catering.fast_food.noodle
catering.fast_food.pita
catering.fast_food.pizza
catering.fast_food.ramen
catering.fast_food.salad
catering.fast_food.sandwich
catering.fast_food.soup
catering.fast_food.tacos
catering.fast_food.tapas
catering.fast_food.wings
catering.food_court
catering.ice_cream
catering.pub
catering.restaurant
catering.restaurant.afghan
catering.restaurant.african
catering.restaurant.american
catering.restaurant.arab
catering.restaurant.argentinian
catering.restaurant.asian
catering.restaurant.austrian
catering.restaurant.balkan
catering.restaurant.barbecue
catering.restaurant.bavarian
catering.restaurant.beef_bowl
catering.restaurant.belgian
catering.restaurant.bolivian
catering.restaurant.brazilian
catering.restaurant.burger
catering.restaurant.caribbean
catering.restaurant.chicken
catering.restaurant.chili
catering.restaurant.chinese
catering.restaurant.croatian
catering.restaurant.cuban
catering.restaurant.curry
catering.restaurant.czech
catering.restaurant.danish
catering.restaurant.dumpling
catering.restaurant.ethiopian
catering.restaurant.european
catering.restaurant.filipino
catering.restaurant.fish
catering.restaurant.fish_and_chips
catering.restaurant.french
catering.restaurant.friture
catering.restaurant.georgian
catering.restaurant.german
catering.restaurant.greek
catering.restaurant.hawaiian
catering.restaurant.hungarian
catering.restaurant.indian
catering.restaurant.indonesian
catering.restaurant.international
catering.restaurant.irish
catering.restaurant.italian
catering.restaurant.jamaican
catering.restaurant.japanese
catering.restaurant.kebab
catering.restaurant.korean
catering.restaurant.latin_american
catering.restaurant.lebanese
catering.restaurant.malay
catering.restaurant.malaysian
catering.restaurant.mediterranean
catering.restaurant.mexican
catering.restaurant.moroccan
catering.restaurant.nepalese
catering.restaurant.noodle
catering.restaurant.oriental
catering.restaurant.pakistani
catering.restaurant.persian
catering.restaurant.peruvian
catering.restaurant.pita
catering.restaurant.pizza
catering.restaurant.portuguese
catering.restaurant.ramen
catering.restaurant.regional
catering.restaurant.russian
catering.restaurant.sandwich
catering.restaurant.seafood
catering.restaurant.soup
catering.restaurant.spanish
catering.restaurant.steak_house
catering.restaurant.sushi
catering.restaurant.swedish
catering.restaurant.syrian
catering.restaurant.tacos
catering.restaurant.taiwanese
catering.restaurant.tapas
catering.restaurant.tex-mex
catering.restaurant.thai
catering.restaurant.turkish
catering.restaurant.ukrainian
catering.restaurant.uzbek
catering.restaurant.vietnamese
catering.restaurant.western
catering.restaurant.wings
catering.taproom Place where you can sample draught cask beer

Emergency

Key Description
emergency General category for emergency-related infrastructure
emergency.assembly_point Safe meeting area designated for people to gather during emergencies
emergency.defibrillator AED (Automated External Defibrillator) for cardiac emergencies
emergency.fire_extinguisher Portable device used to put out small fires
emergency.fire_hydrant Device that provides water supply for firefighting
emergency.fire_service_inlet Inlet connection for fire services to pump water into a building system
emergency.phone Emergency telephone for immediate communication with authorities
emergency.suction_point Designated spot where fire trucks can extract water, e.g., from ponds
emergency.water_tank Storage tank for emergency water supply, especially for firefighting

Education

Key Description
education Place that provides learning spaces and learning environments
education.college
education.driving_school
education.language_school
education.library
education.music_school
education.school
education.university

Childcare

Key Description
childcare Place that provides care of children service while parents are working
childcare.kindergarten

Entertainment

Key Description
entertainment Place that where one can spend free time with amusement
entertainment.activity_park
entertainment.activity_park.climbing
entertainment.activity_park.trampoline
entertainment.amusement_arcade
entertainment.aquarium
entertainment.bowling_alley
entertainment.cinema
entertainment.culture
entertainment.culture.arts_centre
entertainment.culture.gallery
entertainment.culture.theatre
entertainment.escape_game
entertainment.flying_fox
entertainment.miniature_golf
entertainment.museum
entertainment.planetarium
entertainment.theme_park
entertainment.water_park
entertainment.zoo

Healthcare

Key Description
healthcare Places that provides healthcare services: hospitals, clinics and more
healthcare.clinic_or_praxis
healthcare.clinic_or_praxis.allergology
healthcare.clinic_or_praxis.cardiology
healthcare.clinic_or_praxis.dermatology
healthcare.clinic_or_praxis.endocrinology
healthcare.clinic_or_praxis.gastroenterology
healthcare.clinic_or_praxis.general
healthcare.clinic_or_praxis.gynaecology
healthcare.clinic_or_praxis.occupational
healthcare.clinic_or_praxis.ophthalmology
healthcare.clinic_or_praxis.orthopaedics
healthcare.clinic_or_praxis.otolaryngology
healthcare.clinic_or_praxis.paediatrics
healthcare.clinic_or_praxis.psychiatry
healthcare.clinic_or_praxis.pulmonology
healthcare.clinic_or_praxis.radiology
healthcare.clinic_or_praxis.rheumatology
healthcare.clinic_or_praxis.trauma
healthcare.clinic_or_praxis.urology
healthcare.clinic_or_praxis.vascular_surgery
healthcare.dentist
healthcare.dentist.orthodontics
healthcare.hospital
healthcare.pharmacy

Heritage

Key Description
heritage
heritage.unesco

Highway

Key Description
highway Roads, varying from small roads to major routes.
highway.busway Dedicated lanes or roads for bus traffic, often in urban areas
highway.cycleway Designated paths for bicycles, separate from vehicular traffic lanes
highway.footway Paths designated for pedestrian use only, no vehicular traffic
highway.living_street Roads with very low speed limits, prioritizing pedestrians and cyclists
highway.motorway High-capacity roads for fast, long-distance travel with controlled access
highway.motorway.junction Intersections or exits on motorways, often with ramps
highway.motorway.link Ramps or roads connecting to or from a motorway
highway.path General paths for walking, cycling, and sometimes equestrian use
highway.pedestrian Areas primarily intended for pedestrian traffic, often in commercial zones
highway.primary Major roads connecting large towns or cities, important for regional traffic
highway.primary.link Short connectors between primary roads and other road types
highway.public Roads open to the general public, encompassing a wide range of types
highway.residential Roads within residential areas, primarily for local access
highway.secondary Roads connecting smaller towns, less important than primary roads
highway.secondary.link Connectors between secondary roads and adjacent road types
highway.service Roads providing access to buildings, service areas, or other facilities
highway.tertiary Roads linking villages and local centers, less traffic than secondary roads
highway.tertiary.link Small connectors between tertiary roads and other roads
highway.track Unpaved or rough paths primarily used for agricultural or forestry purposes
highway.trunk Major roads with high traffic volume, often linking major cities
highway.trunk.link Ramps or links between trunk roads and other types

Leisure

Key Description
leisure Places where one can relax and unwind
leisure.park
leisure.park.garden
leisure.park.nature_reserve
leisure.picnic
leisure.picnic.bbq
leisure.picnic.picnic_site
leisure.picnic.picnic_table
leisure.playground
leisure.spa
leisure.spa.public_bath
leisure.spa.sauna

Man made

Key Description
man_made The man-made category is used to identify anything that was constructed by humans
man_made.breakwater
man_made.bridge
man_made.lighthouse
man_made.pier
man_made.tower
man_made.water_tower
man_made.watermill
man_made.windmill

Natural

Key Description
natural Places where one can enjoy nature, explore natural phenomena
natural.forest
natural.mountain
natural.mountain.cave_entrance
natural.mountain.cliff
natural.mountain.glacier
natural.mountain.peak
natural.mountain.rock
natural.protected_area
natural.sand
natural.sand.dune
natural.water
natural.water.geyser
natural.water.hot_spring
natural.water.reef
natural.water.sea
natural.water.spring

National park

Key Description
national_park National parks

Office

Key Description
office An office of a business, company, administration, or organization
office.accountant
office.advertising_agency
office.architect
office.association
office.charity
office.company
office.consulting
office.coworking
office.diplomatic
office.educational_institution
office.employment_agency
office.energy_supplier
office.estate_agent
office.financial
office.financial_advisor
office.forestry
office.foundation
office.government
office.government.administrative
office.government.agriculture
office.government.cadaster
office.government.customs
office.government.education
office.government.environment
office.government.forestry
office.government.healthcare
office.government.legislative
office.government.migration
office.government.ministry
office.government.prosecutor
office.government.public_service
office.government.register_office
office.government.social_security
office.government.social_services
office.government.tax
office.government.transportation
office.insurance
office.it
office.lawyer
office.logistics
office.newspaper
office.non_profit
office.notary
office.political_party
office.religion
office.research
office.security
office.tax_advisor
office.telecommunication
office.travel_agent
office.water_utility

Parking

Key Description
parking Places where one can park a car
parking.bicycles
parking.cars
parking.cars.multistorey
parking.cars.rooftop
parking.cars.surface
parking.cars.underground
parking.motorcycle
parking.multistorey
parking.rooftop
parking.surface
parking.underground

Pet

Key Description
pet Places that can be interesting for pet owners
pet.crematorium Crematoria dedicated to pets
pet.dog_park
pet.service
pet.shop
pet.veterinary

Power

Key Description
power Infrastructure related to the generation and distribution of electrical energy
power.generator Facilities where electrical power is generated from various energy sources
power.generator.biomass
power.generator.coal
power.generator.gas
power.generator.geothermal
power.generator.hydro
power.generator.nuclear
power.generator.oil
power.generator.solar
power.generator.wind
power.line High-voltage transmission lines for distributing electricity over long distances
power.minor_line Smaller power lines for local electricity distribution, often within neighborhoods
power.plant Industrial facilities where electrical power is generated from various energy sources.
power.plant.biomass
power.plant.coal
power.plant.gas
power.plant.geothermal
power.plant.hydro
power.plant.nuclear
power.plant.oil
power.plant.solar
power.plant.waste
power.plant.wind
power.substation Facilities that transform voltage levels for distribution and transmission of electricity
power.transformer Devices within power systems that change the voltage level of electricity for distribution

Production

Key Description
production Sites and facilities where goods and products are manufactured or processed
production.brewery Establishments where beer is produced through the fermentation of ingredients
production.cheese Facilities specialized in the production and aging of various types of cheese
production.factory Large industrial buildings where raw materials are transformed into finished goods
production.pottery Workshops or factories where clay products, such as pottery and ceramics, are made
production.winery Facilities dedicated to the production of wine, from grape processing to bottling

Railway

Key Description
railway Tracks and infrastructure for train transportation and services
railway.construction Railway tracks and infrastructure currently under construction
railway.funicular Railways on steep slopes using cable traction for uphill and downhill travel
railway.light_rail Urban rail systems that are lighter and faster than traditional trams
railway.subway Urban, underground railway systems for mass transit
railway.surface Railways located at ground level, including most conventional train tracks
railway.train Tracks used by conventional overground trains for passenger and freight services
railway.tram City-based light rail systems running on streets and dedicated lines
railway.underground Railways located below the surface, typically in urban areas for mass transit

Rental

Key Description
rental Places where one can rent things
rental.bicycle
rental.boat
rental.car
rental.ski
rental.storage

Service

Key Description
service Places that provide services to the public
service.ambulance_station Base for ambulances and emergency medical response teams
service.beauty
service.beauty.hairdresser
service.beauty.massage
service.beauty.spa
service.bookmaker
service.cleaning
service.cleaning.dry_cleaning
service.cleaning.laundry
service.cleaning.lavoir
service.crematorium Human and pet cremation services
service.crematorium.human Cremation services for humans
service.crematorium.pet Cremation services dedicated to pets
service.estate_agent
service.financial
service.financial.atm
service.financial.bank
service.financial.bureau_de_change
service.financial.money_lender
service.financial.money_transfer
service.financial.payment_terminal
service.fire_station Facility where fire service personnel and equipment are based
service.funeral_directors
service.funeral_hall Funeral halls and chapels
service.locksmith
service.mortuary Mortuaries and morgues
service.place_of_mourning Dedicated mourning or wake facilities
service.police
service.post
service.post.box
service.post.office
service.recycling
service.recycling.bin
service.recycling.centre
service.recycling.container
service.social_facility Places that provide social services, such as counseling, support groups, and other assistance to people in need, often run by government or non-profit organizations
service.social_facility.clothers
service.social_facility.food
service.social_facility.shelter
service.tailor
service.taxi
service.travel_agency
service.vehicle
service.vehicle.car_wash
service.vehicle.charging_station
service.vehicle.fuel
service.vehicle.repair
service.vehicle.repair.car
service.vehicle.repair.motorcycle

Tourism

Key Description
tourism Places that can be interesting for tourists
tourism.attraction
tourism.attraction.artwork
tourism.attraction.clock
tourism.attraction.fountain
tourism.attraction.viewpoint
tourism.information
tourism.information.map
tourism.information.office
tourism.information.ranger_station
tourism.sights
tourism.sights.archaeological_site
tourism.sights.battlefield
tourism.sights.bridge
tourism.sights.castle
tourism.sights.city_gate
tourism.sights.city_hall
tourism.sights.conference_centre
tourism.sights.fort
tourism.sights.lighthouse
tourism.sights.memorial
tourism.sights.memorial.aircraft
tourism.sights.memorial.boundary_stone
tourism.sights.memorial.locomotive
tourism.sights.memorial.milestone
tourism.sights.memorial.monument
tourism.sights.memorial.necropolis Historical necropolises
tourism.sights.memorial.pillory
tourism.sights.memorial.railway_car
tourism.sights.memorial.ship
tourism.sights.memorial.tank
tourism.sights.memorial.tomb
tourism.sights.memorial.tumulus Burial mounds and tumuli
tourism.sights.memorial.wayside_cross
tourism.sights.monastery
tourism.sights.place_of_worship
tourism.sights.place_of_worship.cathedral
tourism.sights.place_of_worship.chapel
tourism.sights.place_of_worship.church
tourism.sights.place_of_worship.mosque
tourism.sights.place_of_worship.shrine
tourism.sights.place_of_worship.synagogue
tourism.sights.place_of_worship.temple
tourism.sights.ruines
tourism.sights.tower
tourism.sights.windmill

Religion

Key Description
religion Places that are associated with a particular faith or religious institution, such as churches, mosques, synagogues, temples, and other places of worship
religion.place_of_worship
religion.place_of_worship.buddhism
religion.place_of_worship.christianity
religion.place_of_worship.hinduism
religion.place_of_worship.islam
religion.place_of_worship.judaism
religion.place_of_worship.multifaith
religion.place_of_worship.shinto
religion.place_of_worship.sikhism

Camping

Key Description
camping Places that provide outdoor activity including overnight stay
camping.camp_pitch
camping.camp_site
camping.caravan_site
camping.summer_camp

Amenity

Key Description
amenity Small amenities, that can be useful in different situations
amenity.drinking_water
amenity.give_box Places where people can donate or leave items for others to take for free, often found in public spaces or community centers
amenity.give_box.books
amenity.give_box.food
amenity.toilet

Beach

Key Description
beach A shore of a body of water covered by sand, gravel, or larger rock fragments
beach.beach_resort

Adult

Key Description
adult Places that provide entertainments for adults, sometimes with a sexual context
adult.adult_gaming_centre
adult.brothel
adult.casino
adult.nightclub
adult.stripclub
adult.swingerclub

Building

Key Description
building Stand alone buildings and places
building.accommodation
building.catering
building.college
building.commercial
building.dormitory
building.driving_school
building.entertainment
building.facility
building.garage
building.healthcare
building.historic
building.holiday_house
building.industrial
building.kindergarten
building.military
building.office
building.parking
building.place_of_worship
building.prison
building.public_and_civil
building.residential
building.school
building.service
building.spa
building.sport
building.toilet
building.tourism
building.transportation
building.university

Ski

Key Description
ski Infrastructure objects related to downhill skiing sport kinds
ski.lift
ski.lift.cable_car
ski.lift.chair_lift
ski.lift.gondola
ski.lift.magic_carpet
ski.lift.mixed_lift
ski.lift.tow_line

Sport

Key Description
sport Infrastructure objects related to different sport kinds
sport.dive_centre
sport.fitness
sport.fitness.fitness_centre
sport.fitness.fitness_station
sport.horse_riding
sport.ice_rink
sport.pitch
sport.sports_centre
sport.stadium
sport.swimming_pool
sport.track

Public transport

Key Description
public_transport Public transport stations and stops
public_transport.aerialway
public_transport.bus
public_transport.ferry
public_transport.light_rail
public_transport.monorail
public_transport.subway
public_transport.subway.entrance
public_transport.train
public_transport.tram

Administrative

Key Description
administrative Administrative boundary
administrative.city_level
administrative.continent_level
administrative.country_level
administrative.country_part_level
administrative.county_level
administrative.district_level
administrative.neighbourhood_level
administrative.state_level
administrative.suburb_level

Postal code

Key Description
postal_code Postcode boundary

Political

Key Description
political Political boundary

Low emission zone

Key Description
low_emission_zone Low emission zone

Populated place

Key Description
populated_place Place where people live
populated_place.allotments
populated_place.borough
populated_place.city
populated_place.city_block
populated_place.county
populated_place.district
populated_place.hamlet
populated_place.municipality
populated_place.neighbourhood
populated_place.province
populated_place.quarter
populated_place.region
populated_place.state
populated_place.subdistrict
populated_place.suburb
populated_place.town
populated_place.township
populated_place.village

Memorial

Key Description
memorial Generic memorial points of interest
memorial.buddhist Buddhist memorial sites
memorial.cemetery Cemeteries and burial complexes
memorial.cemetery.sector Individual sectors inside large cemeteries
memorial.christian Christian memorial sites
memorial.christian.catholic Catholic memorial sites
memorial.christian.orthodox Orthodox memorial sites
memorial.christian.protestant Protestant memorial sites
memorial.graveyard Graveyards without formal boundaries
memorial.hindu Hindu memorial sites
memorial.jewish Jewish memorial grounds
memorial.muslim Muslim memorial grounds

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.

Key Description
internet_access Places that provide an internet access
internet_access.free Internet access is available without charge
internet_access.for_customers Internet access is limited to paying guests or registered customers
wheelchair Places that are suitable to be used with wheelchairs
wheelchair.yes Fully wheelchair-accessible facilities
wheelchair.limited Partial wheelchair access (for example, only some entrances or floors)
dogs Places where dogs are allowed
dogs.yes Dogs are welcome without additional restrictions
dogs.leashed Dogs must remain on a leash
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 Entry restricted to private guests or members
access_limited.customers Entry limited to customers only
access_limited.with_permit Entry requires a special permit or authorization
access_limited.services Entry controlled by staff or security 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 Explicitly marked as free of charge
no_fee.not_specified Fee information is not provided
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

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

Try to search places with a country filter

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

Try to search places with conditions

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

Try to search places within visible area

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

Try to search places within a city district

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

Try to search places near a location with radius filter

The bias parameter sorts the results by distance to the location you provide.

Search places nearest to a location

Using the bias parameter without a filter returns the closest places sorted by distance from the point you provide:

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

Try to search places near a location

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

Try to search large number of places

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

Try to search large number of places with offset

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.