Geoapify Place Info API
The Place Info API from Geoapify — 1 operation(s) for place info.
The Place Info API from Geoapify — 1 operation(s) for place info.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/geoapify:geoapify-place-info-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Geoapify Place Info API
version: 2.1.1
description: Retrieve categorized place information for coordinates or an OpenStreetMap object.
servers:
- url: https://api.geoapify.com/v2
description: Default API endpoint.
- url: https://api-eu.geoapify.com/v2
description: EU-focused endpoint. Geoapify service processing uses EU infrastructure.
security:
- ApiKeyInQuery: []
- ApiKeyInHeader: []
tags:
- name: Place Info
paths:
/place-info:
get:
tags:
- Place Info
operationId: getPlaceInfo
summary: Get place information
parameters:
- name: lat
in: query
required: false
description: Place latitude. Must be used with lon.
schema:
type: number
minimum: -90
maximum: 90
- name: lon
in: query
required: false
description: Place longitude. Must be used with lat.
schema:
type: number
minimum: -180
maximum: 180
- name: osm_id
in: query
required: false
description: OpenStreetMap object identifier.
schema:
type: number
- name: osm_type
in: query
required: false
description: OpenStreetMap object type.
schema:
type: string
enum:
- r
- w
- n
- name: name
in: query
required: false
description: Optional place name.
schema:
type: string
minLength: 3
maxLength: 1024
- name: isBuilding
in: query
required: false
description: Whether the requested object is a building.
schema:
type: boolean
- name: skipAddress
in: query
required: false
description: Skip address enrichment.
schema:
type: boolean
- name: lang
in: query
required: false
description: Result language.
schema:
type: string
enum:
- ab
- aa
- af
- ak
- sq
- am
- ar
- an
- hy
- as
- av
- ae
- ay
- az
- bm
- ba
- eu
- be
- bn
- bh
- bi
- bs
- br
- bg
- my
- ca
- ch
- ce
- ny
- zh
- cv
- kw
- co
- cr
- hr
- cs
- da
- dv
- nl
- en
- eo
- et
- ee
- fo
- fj
- fi
- fr
- ff
- gl
- ka
- de
- el
- gn
- gu
- ht
- ha
- he
- hz
- hi
- ho
- hu
- ia
- id
- ie
- ga
- ig
- ik
- io
- is
- it
- iu
- ja
- jv
- kl
- kn
- kr
- ks
- kk
- km
- ki
- rw
- ky
- kv
- kg
- ko
- ku
- kj
- la
- lb
- lg
- li
- ln
- lo
- lt
- lu
- lv
- gv
- mk
- mg
- ms
- ml
- mt
- mi
- mr
- mh
- mn
- na
- nv
- nb
- nd
- ne
- ng
- nn
- 'no'
- ii
- nr
- oc
- oj
- cu
- om
- or
- os
- pa
- pi
- fa
- pl
- ps
- pt
- qu
- rm
- rn
- ro
- ru
- sa
- sc
- sd
- se
- sm
- sg
- sr
- gd
- sn
- si
- sk
- sl
- so
- st
- es
- su
- sw
- ss
- sv
- ta
- te
- tg
- th
- ti
- bo
- tk
- tl
- tn
- to
- tr
- ts
- tt
- tw
- ty
- ug
- uk
- ur
- uz
- ve
- vi
- vo
- wa
- cy
- wo
- fy
- xh
- yi
- yo
- za
default: en
responses:
'200':
description: Place information result.
content:
application/json:
schema:
$ref: '#/components/schemas/FeatureCollection'
'400':
description: Invalid request.
'401':
description: Missing or invalid Geoapify API key.
'429':
description: Rate limit or quota exceeded.
'500':
description: Internal gateway error.
components:
schemas:
Feature:
type: object
additionalProperties: true
required:
- type
- properties
- geometry
properties:
type:
const: Feature
properties:
$ref: '#/components/schemas/PlaceInfoProperties'
geometry:
oneOf:
- $ref: '#/components/schemas/PointGeometry'
- $ref: '#/components/schemas/GenericGeometry'
- $ref: '#/components/schemas/GeometryCollection'
bbox:
type: array
minItems: 4
maxItems: 6
items:
type: number
PlacesDatasource:
type: object
required:
- raw
properties:
sourcename:
type: string
attribution:
type: string
license:
type: string
url:
type: string
format: uri
raw:
type: object
additionalProperties: true
PointGeometry:
type: object
required:
- type
- coordinates
properties:
type:
const: Point
coordinates:
$ref: '#/components/schemas/Position'
PlaceInfoProperties:
type: object
properties:
name:
type: string
continent:
type: string
country:
type: string
country_code:
type: string
region:
type: string
state:
type: string
state_code:
type: string
state_COG:
type: string
department_COG:
type: string
state_district:
type: string
province:
type: string
department:
type: string
arrondissement:
type: string
county:
type: string
county_code:
type: string
county_district:
type: string
city:
type: string
city_district:
type: string
postcode:
type: string
postal_code:
type: string
openGeoDB:postal_codes:
type: string
district:
type: string
suburb:
type: string
municipality:
type: string
commune:
type: string
subdistrict:
type: string
city_block:
type: string
neighbourhood:
type: string
quarter:
type: string
section:
type: string
sector:
type: string
subdivision:
type: string
croft:
type: string
allotments:
type: string
residental:
type: string
farm:
type: string
farmyard:
type: string
industrial:
type: string
retail:
type: string
borough:
type: string
town:
type: string
township:
type: string
village:
type: string
hamlet:
type: string
locality:
type: string
isolated_dwelling:
type: string
street:
type: string
road:
type: string
footway:
type: string
pedestrian:
type: string
path:
type: string
housenumber:
type: string
house_number:
type: string
house_name:
type: string
old_name:
type: string
other:
type: string
formatted:
type: string
address_line1:
type: string
address_line2:
type: string
unlocode:
type: string
iso3166_2:
type: string
iso3166_2_sublevel:
type: string
iso3166_sublevel:
type: string
plus_code:
type: string
plus_code_short:
type: string
postcodes:
type: array
items:
type: string
other_names:
type: object
additionalProperties:
type: string
lon:
type: number
minimum: -180
maximum: 180
lat:
type: number
minimum: -90
maximum: 90
parent_as_place_id:
type: boolean
timezone:
$ref: '#/components/schemas/TimezoneOutput'
population:
oneOf:
- type: number
- $ref: '#/components/schemas/WikiPopulation'
distance:
type: number
categories:
type: array
items:
type: string
details:
type: array
items:
type: string
datasource:
$ref: '#/components/schemas/PlacesDatasource'
mappedTo:
type: object
properties:
lon:
type: number
minimum: -180
maximum: 180
lat:
type: number
minimum: -90
maximum: 90
place_id:
type: string
minLength: 3
maxLength: 2048
website:
type: string
opening_hours:
type: string
opening_hours_covid19:
type: string
brand:
type: string
operator:
type: string
branch:
type: string
network:
type: string
owner:
type: string
description:
type: string
craft:
type: string
ref:
type: string
int_ref:
type: string
ele:
type: string
color:
type: string
water_source:
type: string
website_other:
type: array
items:
type: string
website_international:
$ref: '#/components/schemas/StringMap'
description_international:
$ref: '#/components/schemas/StringMap'
name_international:
$ref: '#/components/schemas/StringMap'
cuisine_international:
$ref: '#/components/schemas/StringMap'
ref_other:
$ref: '#/components/schemas/StringMap'
disused:
type: boolean
commercial:
oneOf:
- type: string
- $ref: '#/components/schemas/PlaceDetailGroup'
payment_options:
$ref: '#/components/schemas/BooleanMap'
recycling_options:
$ref: '#/components/schemas/BooleanMap'
fuel_options:
$ref: '#/components/schemas/BooleanMap'
targeted_for:
$ref: '#/components/schemas/BooleanMap'
socket_options:
type: object
additionalProperties:
$ref: '#/components/schemas/PlaceDetailGroup'
brand_details:
$ref: '#/components/schemas/PlaceDetailGroup'
operator_details:
$ref: '#/components/schemas/PlaceDetailGroup'
network_details:
$ref: '#/components/schemas/PlaceDetailGroup'
owner_details:
$ref: '#/components/schemas/PlaceDetailGroup'
name_other:
$ref: '#/components/schemas/PlaceDetailGroup'
contact:
$ref: '#/components/schemas/PlaceDetailGroup'
facilities:
$ref: '#/components/schemas/PlaceDetailGroup'
wiki_and_media:
$ref: '#/components/schemas/PlaceDetailGroup'
historic:
$ref: '#/components/schemas/PlaceDetailGroup'
heritage:
$ref: '#/components/schemas/PlaceDetailGroup'
artwork:
$ref: '#/components/schemas/PlaceDetailGroup'
accommodation:
$ref: '#/components/schemas/PlaceDetailGroup'
catering:
$ref: '#/components/schemas/PlaceDetailGroup'
parking:
$ref: '#/components/schemas/PlaceDetailGroup'
airport:
$ref: '#/components/schemas/PlaceDetailGroup'
power:
$ref: '#/components/schemas/PlaceDetailGroup'
way:
$ref: '#/components/schemas/PlaceDetailGroup'
building:
$ref: '#/components/schemas/PlaceDetailGroup'
place_of_worship:
$ref: '#/components/schemas/PlaceDetailGroup'
fire_hydrant:
$ref: '#/components/schemas/PlaceDetailGroup'
defibrilator:
$ref: '#/components/schemas/PlaceDetailGroup'
restrictions:
$ref: '#/components/schemas/PlaceDetailGroup'
production:
$ref: '#/components/schemas/PlaceDetailGroup'
PlaceDetailValue:
oneOf:
- type: string
- type: number
- type: boolean
- type: 'null'
- type: array
items:
$ref: '#/components/schemas/PlaceDetailValue'
- type: object
additionalProperties:
$ref: '#/components/schemas/PlaceDetailValue'
Position:
type: array
minItems: 2
maxItems: 3
prefixItems:
- type: number
minimum: -180
maximum: 180
- type: number
minimum: -90
maximum: 90
- type: number
items: false
GenericGeometry:
type: object
additionalProperties: true
required:
- type
- coordinates
properties:
type:
type: string
enum:
- LineString
- Polygon
- MultiPoint
- MultiLineString
- MultiPolygon
coordinates:
type: array
WikiPopulation:
type: object
required:
- actual
- by_years
properties:
actual:
type: string
by_years:
type: object
additionalProperties:
type: string
PlaceDetailGroup:
type: object
additionalProperties:
$ref: '#/components/schemas/PlaceDetailValue'
BooleanMap:
type: object
additionalProperties:
type: boolean
GeometryCollection:
type: object
required:
- type
- geometries
properties:
type:
const: GeometryCollection
geometries:
type: array
items:
oneOf:
- $ref: '#/components/schemas/PointGeometry'
- $ref: '#/components/schemas/GenericGeometry'
- $ref: '#/components/schemas/GeometryCollection'
FeatureCollection:
type: object
additionalProperties: true
required:
- type
- features
properties:
type:
const: FeatureCollection
features:
type: array
items:
$ref: '#/components/schemas/Feature'
TimezoneOutput:
type: object
required:
- name
- offset_STD
- offset_DST
- offset_STD_seconds
- offset_DST_seconds
properties:
name:
type: string
name_alt:
type: string
country_codes:
type: array
items:
type: string
offset_STD:
type: string
offset_DST:
type: string
offset_STD_seconds:
type: number
offset_DST_seconds:
type: number
abbreviation_STD:
type: string
abbreviation_DST:
type: string
StringMap:
type: object
additionalProperties:
type: string
securitySchemes:
ApiKeyInQuery:
type: apiKey
in: query
name: apiKey
description: Geoapify API key query parameter. Recommended authentication method for public APIs. API keys in URLs can be logged; use x-api-key for server-to-server clients.
ApiKeyInHeader:
type: apiKey
in: header
name: x-api-key
description: Geoapify API key header. Supported as an alternative authentication method for public APIs.
x-provenance:
method: harvested
publisher: Geoapify
source: https://apidocs.geoapify.com/assets/openapi/specs/place-info/place-info-api-openapi-specs.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)