Build with Placey.

A REST API and a 4kb JavaScript widget. Pick whichever fits your stack — both work with the same API key.

Quickstart

Grab a free API key from your dashboard, then make a request:

curl "https://api.placey.io/v1/lookup?postcode=SW1A1AA" \
  -H "Authorization: Bearer pk_live_..."

Authentication

All requests use bearer tokens. Live keys start with pk_live_; test keys with pk_test_ never count against your quota.

Authorization: Bearer pk_live_...

Endpoints

  • GET
    /v1/lookup

    Resolve a full postcode to all matching addresses

  • GET
    /v1/autocomplete

    As-you-type predictions (free, rate-limited)

  • GET
    /v1/typeahead

    Single-field suggestions (city, county…)

  • POST
    /v1/validate

    Bulk validate a list of addresses

JavaScript widget

One script tag, zero framework dependencies:

<script src="https://cdn.placey.io/widget.js"></script>
<script>
  Placey.autocomplete("#postcode", "pk_live_...", {
    onSelect: (address) => console.log(address),
  });
</script>

Errors & rate limits

Placey returns standard HTTP status codes. Autocomplete is rate-limited to 10 requests/second per key; resolution endpoints are not.

{
  "error": {
    "code": "rate_limited",
    "message": "Slow down — try again in 1s"
  }
}