Address Search

Search 528M+ verified government addresses by house number, street name and city.

GET

Parameters

Parameter	Type	Required	Description
`q`	string	Required	Address query, e.g. "1 Martin Place"
`country`	string	Required	ISO2 country code (e.g., AU, US, BR)
`city`	string	Optional	City name for improved accuracy
`postal_code`	string	Optional	Filter results by postal code
`limit`	integer	Optional	Results count 1-50 (default: 10)

Request Example

curl "https://api.localityapi.com/v1/address?q=1%20Martin%20Place&country=AU&city=Sydney" \
  -H "X-API-Key: lapi_your_key"

Response

json

{
  "results": [
    {
      "id": 84771203,
      "house_number": "1",
      "street": "Martin Place",
      "city": "Sydney",
      "admin1": "New South Wales",
      "postal_code": "2000",
      "country": "AU",
      "lat": -33.86785,
      "lng": 151.20732
    }
  ],
  "count": 1,
  "query_ms": 14
}

Response Fields

resultsarrayArray of matching addresses

results[].idintegerUnique address identifier

results[].house_numberstringHouse or building number

results[].streetstringStreet name

results[].citystringCity name

results[].admin1stringPrimary admin region (state/province)

results[].postal_codestringPostal or ZIP code

results[].countrystringISO2 country code

results[].latnumberLatitude

results[].lngnumberLongitude

countintegerTotal number of results

query_msintegerQuery execution time in milliseconds