/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, an optional cursor, and the remaining Places calls.
| hits | object[] | ||||||
| cursor | string | null | ||||||
| remainingUsage | object Remaining Search Places calls for this workspace, in the same shape as a connected account remainingUsage.
| ||||||
| requestId | string · uuid Id of this request, for support and troubleshooting |
Errors
- 400: Bad request
- 401: Unauthorized: missing or invalid API key
- 403: Forbidden
- 404: Not found
- 422: Invalid request payload