Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ESRI ArcGIS Places API

Points of interest search and retrieval

ESRI ArcGIS Places API is one of 8 APIs that ESRI ArcGIS publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Places. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and an API reference.

This API exposes 2 operations across 2 paths, and defines 6 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 4 base URLs: https://www.arcgis.com/sharing/rest, https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer, https://route.arcgis.com/arcgis/rest/services, https://places-api.arcgis.com/arcgis/rest/services/v1.

2 operations 2 paths 6 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://www.arcgis.com/sharing/rest
Authentication
API Key, OAuth 2.0
Resource Areas
1

Authentication & Security 2

ESRI ArcGIS Places API declares 2 security schemes for authenticating requests. An API key is passed in the query as token (ApiKeyAuth). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

  • ApiKeyAuth — ArcGIS API key or token

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Places 2

Points of interest search and retrieval

GET
/places/near-point
Find places near a point
findPlacesNearPoint 7 params → 200
GET
/places/{placeId}
Get place details
getPlaceDetails 4 params → 200404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are Place (7 properties), PlaceSummary (5 properties), Point (3 properties), PlacesResponse (2 properties). Each schema is shown below with its type and property counts.

SpatialReference
object
2 properties
Point
object
3 properties
PlaceSummary
object
5 properties
Category
object
2 properties
Place
object
7 properties
PlacesResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

esri-arcgis-places-api-openapi.yml Raw ↑

Other APIs ESRI ArcGIS publishes across the network.

ArcGIS Maps SDK for JavaScript
ArcGIS API for Python
ArcGIS Geocoding Service
ArcGIS Routing Service
ArcGIS Places Service
ESRI ArcGIS Geocoding API
ESRI ArcGIS Portal API