apyhub
▣ DATA VALIDATION · GEOLOCATION

Search US Address API

What it does

Address Search lets you look up address matches from a free-text query, with optional country filtering and result limiting.

Send a query string and get address search results back in the response. You can also pass country_code to narrow the search to a two-letter country code, and limit to control how many matches are returned, up to 200. The request schema requires query, so this is built for autocomplete, form assistance, and address lookup flows where the user starts with partial address text.

Use Address Search when you need to suggest likely addresses as a user types, validate that a submitted address can be resolved, or reduce manual entry in shipping, onboarding, and contact forms. Because the response schema is open-ended, you should treat the returned payload as a structured address search result set rather than rely on fixed fields beyond what the API provides.

If you are building checkout, CRM enrichment, or delivery workflows, Address Search gives you a simple way to turn a partial address string into candidate matches without inventing your own search layer.

GET
Search addresses
https://api.eu.apyhub.com/dosvak/search-addresses

QUICKSTART

GUIDE

Quickstart

Search for addresses using a required query string, with optional limit and country code parameters.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-addresses?query=1600%20Amphitheatre" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the search query, the number of matches found, and the matching address results.

{
  "query": "1600 Amphitheatre",
  "count": 1,
  "results": [
    {
      "address_line": "1600 Amphitheatre Pkwy",
      "locality": "Mountain View",
      "country_code": "US"
    }
  ]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches for addresses using a text query and returns a JSON object response. The request accepts query parameters for the search text, an optional result limit, and an optional country code.

Query Parameter(s)

AttributeTypeMandatoryDescription
limitIntegerNoMaximum number of results to return. Default: 20. Minimum: 1. Maximum: 200.
queryStringYesSearch text. Minimum length: 2.
country_codeStringNoOptional 2-character country code.

Response

Returns a JSON object containing the search query, number of matches, matching addresses, and attribution information.

Query parameters

Name
Type
Description
limitOPTIONAL
integer
—
DEFAULT 20
queryREQUIRED
string
—
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.