Gggle Get API keys

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.

bash
# nothing to install — it is just HTTP

2. Call /predict

Send a query string and your key. Browser (pk) keys must be locked to your origins.

bash
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.

json
{ "hits": [ { "name": "York", "type": "town", "geo_point": { "lat": 53.96, "lon": -1.08 } } ] }

Updated 21 Jul 2026