/api/v1/places/search
Request bodyrequired
| queryoptional | string Free-text query, e.g. "dentists in Munich". Required unless `location` is set. | ||||
| locationoptional | object Center point. Required unless `query` is set. Without a query this is a nearby search inside the radius.
| ||||
| radiusMetersoptional | integer Radius when `location` is set. Defaults to 50 km. Nearby search stays inside this circle; text search is biased toward it. | ||||
| typeoptional | string A Google Places type such as `restaurant` or `dentist`. | ||||
| languageoptional | string BCP-47 language code for names and addresses. | ||||
| regionoptional | string CLDR region code that biases results, e.g. `DE`. | ||||
| cursoroptional | string Text-search pagination cursor. Nearby search does not page. | ||||
| limitoptional | integer |
Response
200Place hits and an optional cursor.
| hits | object[] |
| cursor | string | null |
Errors
- 400: Bad request
- 401: Unauthorized: missing or invalid API key
- 403: Forbidden
- 404: Not found
- 422: Invalid request payload