Skip to main content
GET
Search for places by keyword
For easy integration with web and Android projects, this service is also available through our JavaScript and Java libraries.
The response is deliberately small and leaves out geographic coordinates. To get coordinates for a result, pass its placeId to the Places API.

Authorizations

key
string
query
required

Your Baato access token. See Authentication.

Query Parameters

q
string
required

The search keyword to look for results against.

lat
number<double>

Latitude to bias results towards. Useful in mobile applications for providing geographical context to the search. Must be sent together with lon.

lon
number<double>

Longitude to bias results towards. Must be sent together with lat.

type
string

The type or category of results the request should return, for example hospital or cafe.

radius
integer
default:10

Radius in kilometres from the specified lat/lon pair within which to look for results. Only integer values are supported.

limit
integer
default:5

The number of results the request should return.

Response

Matching place suggestions.

timestamp
string

Server time when the response was generated.

Example:

"Thu May 14 07:35:16 NPT 2020"

status
integer

HTTP-style status code echoed in the response body.

Example:

200

message
string
Example:

"Success"

data
object[]