---
title: Search US Address API
slug: search-addresses
url: https://apyhub.com/dosvak/service/search-addresses
provider: Dosvak LLC
categories: [Data Validation, Geolocation, Standard Data]
tags: [address-search, address-lookup, geocoding, autocomplete, location-data]
auth: api_key
version: 0.1.0
service_type: sync
endpoints: 1
atoms: 100
mcp: true
---

# Search US Address API

Search address matches from a text query, with optional country filtering and result limits. Built for autocomplete, lookup, and validation.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/dosvak/search-addresses` | What it does Searches for addresses using a text query and returns a JSON object response. The requ… | 100 |

## Endpoint reference

### Search addresses 

`GET https://api.eu.apyhub.com/dosvak/search-addresses` · 100 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | no | Limit Default: `20`. Example: `10`. |
| `query` | query | string | yes | Query Example: `1600 Amphitheatre`. |

#### Quickstart

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

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

```json
{
  "query": "1600 Amphitheatre",
  "count": 1,
  "results": [
    {
      "address_line": "1600 Amphitheatre Pkwy",
      "locality": "Mountain View",
      "country_code": "US"
    }
  ]
}
```

## About

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

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/search-addresses