Places service (beta)

The places service is a ready-to-use location service that can search for businesses and geographic locations around the world. It allows you to find, locate, and discover detailed information about each place.

This documentation is the REST API reference for the service endpoint, requests, parameters, and supported types.

Get started

You can use the service to:

  • Search for places near a location.
  • Search for places within an extent.
  • Filter places using categories and/or text.
  • Find place attributes such as name, address, description, opening hours, price ratings, user ratings, and social links.
  • Find categories by name or ID.

Need an account?

Sign up for a free ArcGIS account

places image

To learn how to access the service with ArcGIS, open source, and scripting APIs, go to the Mapping APIs and location services guide.

Service URL

Use dark colors for code blocksCopy


/places/near-pointSearch for places near a point or location by radius.
/places/within-extentSearch for places within an extent (bounding box).
/places/{placeId}Get place details including name, address, description, and other attributes.
/categoriesReturn the name and category ID of all categories, or categories which satisfy a filter.
/categories/{categoryId}Get the category details for a category ID.


To access the places service, you need an ArcGIS Developer account and you need to use one of the following authentication methods:

  • API key: A permanent token that grants your application access to ready-to-use services. The API key must include the places (beta) scope.

  • ArcGIS Identity (formerly named user): A short-lived token, generated via OAuth 2.0, giving your application permission to access the service authorized to an existing ArcGIS user's account.

API support

Full supportPartial supportNo support
  • 1. Access via ArcGIS REST JS.


You can only access the places service if you have an ArcGIS Developer account. ArcGIS Online accounts are not supported.

You can access the service with ArcGIS REST JS or the ArcGIS REST API, but currently, the ArcGIS Maps SDKs do not provide full API support. See the support table above.


Terms of use

You cannot store places or place details for future use. To see a complete description of the allowable usage, please see the Terms of use.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.