Gggle Get API keys

Search & places

Address lookup

Instant postcode, street, town & county lookup for Great Britain.

The Address API turns a postcode into its town, county and street, and a street name into its matching locations across Great Britain — instant, and priced as one lookup per request.

Scope: address.

Autocomplete as you type

Send a partial query and get ranked street + postcode suggestions — everything you need to power a fast, friendly address finder. Add a town or county to narrow a common street (bedford road kempston), or type a house number with a postcode (52 MK45 3GL) and each matching street comes back with the number already in place.

request
curl "https://api.goggleplaces.com/address?q=acacia av" \
  -H "x-api-key: gk_live_pk_…"
response
{
  "suggestions": [
    { "type": "street", "label": "Acacia Avenue", "town": "Knutsford",
      "county": "Cheshire East", "postcode_area": "WA16",
      "location": { "lat": 53.30, "lng": -2.37 } }
  ]
}

House number + postcode returns each street the postcode serves, with the number prepended — ready to drop straight into an address line:

request
curl "https://api.goggleplaces.com/address?q=52 MK45 3GL" \
  -H "x-api-key: gk_live_pk_…"
response
{
  "suggestions": [
    { "type": "address", "house": "52", "street": "Horseshoe Crescent",
      "label": "52 Horseshoe Crescent", "town": "Wixams",
      "county": "Central Bedfordshire", "postcode": "MK45 3GL",
      "location": { "lat": 52.08, "lng": -0.48 } }
  ]
}

Look up a postcode

Return the town, county and street for a postcode, with a map-ready location.

request
curl "https://api.goggleplaces.com/address?postcode=MK45 3GL" \
  -H "x-api-key: gk_live_pk_…"
response
{
  "postcode": "MK45 3GL",
  "town": "Wixams",
  "county": "Central Bedfordshire",
  "street": { "name": "Horseshoe Crescent" },
  "streets": [
    { "name": "Horseshoe Crescent", "town": "Wixams", "county": "Central Bedfordshire" }
  ],
  "location": { "lat": 52.08, "lng": -0.48 }
}

Look up a street

Return the town / county / postcode-area options for a street name — perfect for disambiguating a street that exists in several towns.

request
curl "https://api.goggleplaces.com/address?street=Acacia Avenue&limit=5" \
  -H "x-api-key: gk_live_pk_…"

SDK

sdk.js
import { address, addressAutocomplete, addressFinder } from '@goggleplaces/sdk'

// as-you-type suggestions
const hits = await addressAutocomplete({ key, q: 'MK45 3' })

// resolve a postcode
const r = await address({ key, postcode: 'MK45 3GL' })

// drop-in finder → auto-fill
addressFinder({ container: 'addr', key, onResult: (r) => {
  form.town.value = r.town
  form.county.value = r.county
}})

Attribution

Every response includes an attribution string — display it as described in our Terms.