Getting started
Quickstart
Get a key and make your first predictive-search call in two minutes.
1. Get a key
Create an organisation in the dashboard and mint a publishable (pk) or secret (sk) key.
# nothing to install — it is just HTTP2. Call /predict
Send a query string and your key. Browser (pk) keys must be locked to your origins.
curl "https://api.goggleplaces.com/predict?q=York" \
-H "x-api-key: gk_live_pk_..."3. Read the response
You get ranked hits with a geo_point you can drop straight onto a map.
{ "hits": [ { "name": "York", "type": "town", "geo_point": { "lat": 53.96, "lon": -1.08 } } ] }Updated 21 Jul 2026