Places

Search for places

Find places by what they are and where they are, such as bakeries in Curitiba. Places we saved from earlier searches come back at once, for free. If they do not fill limit, a collection starts to find the rest and the answer includes it: each new place costs one credit as it arrives, and it stops at limit, so a search never costs more than limit credits. Search again later, or read the collection, to get the new ones; with wait, the answer waits up to 60 seconds for them. Needs an API key.

post/places/search

Request

  • Base URL: https://api.gmaps.dev/v1
  • URL: https://api.gmaps.dev/v1/places/search
  • Auth: HTTP bearer

Request body

keywordsstring[] required

What to search for, such as ["bakery"]. One search per term.

langstring

The language to search in. New places come back in it. Two letters, such as pt or en.

minRatingnumber nullable

Keep only places rated at least this, from 1 to 5. Null keeps every place.

limitinteger

How many places you want, from 1 to 120. Also the most a search can cost.

waitinteger

Seconds to wait for new places when we have to collect them, up to 60. 0 answers at once with what we already have.

Response

Search for places

Changes

No recorded changes to this operation across all 1 revision of this API.