Skip to main content
Six endpoints cover keyword search, reverse geocoding, place lookup, proximity search, routing and vector map styles. All of them are plain HTTP GET requests returning JSON, so you can integrate from any language without an SDK.

Base URL

https://api.baato.io/api/v1 — authenticate with a key query parameter on every request.

​
Endpoints

Search

Keyword-based place suggestions, optimised for search and autocomplete UIs.

Reverse Search

Turn a lat/lon pair into a human-readable address.

Places

Full geographic detail — centroid, geometry and tags — for a known place ID.

Nearby Places

Find places of a given type around a coordinate.

Directions

Navigation routes with distance and time estimates.

Map Styles

Vector map styles following the Mapbox Style Specification.

​
Before you begin

1

Get an access token

Every endpoint requires one. See Authentication — a free account gets you a working token immediately.
2

Know the conventions

Coordinate order, the response envelope and encoded polylines are covered in Core concepts. They account for most first-integration bugs.
3

Try a request

Each endpoint page below has a live playground — paste your token in and run a real request without writing any code.
Endpoint URLs carry an explicit version. See API versioning for how new versions are introduced and how to pin one.

​
Handling failures

Baato returns conventional HTTP status codes, with an explanatory message in the body. See Errors and status codes for what each code means and when to retry.