Places API
API Reference
Reference for the Open Places API endpoint, query parameters, responses, headers, and OpenAPI contract.
Operation
GET /v1/places
Searches place names and scoped addresses near a latitude/longitude point. The source contract has a readable preview at OpenAPI YAML.
GET
https://api.openplacesapi.com/v1/places Authenticated public search endpoint for server-side integrations.
Query parameters
Inputs accepted by the search endpoint.
| Name | Type | Required | Details |
|---|---|---|---|
q | string | Yes | Search text, 3 to 128 characters after normalization. |
lat | number | Yes | Latitude from -90 to 90. |
lon | number | Yes | Longitude from -180 to 180. |
radius_mi | number | No | Defaults to 25; maximum is 50. |
mode | enum | No | all, name, or address. Defaults to all. |
limit | integer | No | Defaults to 10; maximum is 20. |
layer_preset | string | No | Account-owned preset slug. Mutually exclusive with layers. |
layers | string | No | Explicit ordered selection such as base,open,account:client-a. |
Responses
Success, quota, and error responses are explicit.
| Status | Response |
|---|---|
200 | Search completed, including zero-result searches. |
400, 422 | Validation or unsupported query shape. |
401, 403 | Authentication or layer authorization failure. |
402, 429, 503 | Quota exhausted, rate limited, or temporarily unavailable. |
JSON SearchResponse
{
"results": [
{
"id": "place_01h...",
"name": "Coffee Shop",
"address": "123 Example St",
"lat": 40.7128,
"lon": -74.006
}
],
"warnings": []
}