Skip to main content
GET
Autocomplete free-text places

Authorizations

Authorization
string
header
default:sk_test_DEMO0000_replace_with_your_sandbox_key
required

API key authentication. Issued by the Safariat admin or via the partner portal. The secret is shown only once at generation.

Production sk_live_* keys must additionally sign every write request (POST/PUT/DELETE) with the X-Timestamp and X-Signature headers. Sandbox sk_test_* keys are exempt from request signing: X-Signature and X-Timestamp are not required for writes in the sandbox (so the developer-portal "Try it" playground works end to end). The Idempotency-Key header remains required on writes in both environments.

Query Parameters

q
string
required

Free-text query. Fewer than 3 characters returns an empty list without calling Google.

Example:

"marr"

country
string
default:MA

ISO 3166-1 alpha-2 region bias.

Example:

"MA"

lang
string

Label language (fr, en, ar).

Example:

"fr"

session_token
string

Opaque session token tying the autocomplete calls to the following /places/details call.

Response

Predictions (possibly empty)

data
object[]
required