To start searching for places, you should identify one or more place categories for the types of places you are interested in. Categories are used to help filter search results so only the type of places you are interested in are returned. All categories have a name and a unique ID. To help find the appropriate category (and ID), you can use the /categories request or the places category finder tool.
To search for places you can use the /places/near-point or /places/within-extent request. To filter and return the best results, you should provide a list of categories and/or keywords when you search. When places are returned, they contain attributes such as name, placeId, location, and categories. You can use the place attributes to display them on a map or to get more details about each place.
After you perform a place search, you can use /places/{placeId} to request additional attributes for each place. To do so, you use a place ID and set the requestedFields parameter to specify the fields you want. The request fields are grouped into Place, Address, and/or Detailsprice groups. The number of attributes returned can vary depending on the type of place.