apyhub
▣ DATA VALIDATION · DEVELOPER TOOLS

Parse & Normalize US Address API

What it does

Address Parser normalizes a free-form address string into a structured response you can use in downstream systems. Send an address_line, and optionally a country_code, then get the parsed result back.

Use it when user-entered addresses need to be cleaned before storage, shipping, billing, or validation steps. It is useful for checkout forms, CRM imports, deduplication workflows, and any integration that needs a consistent address representation instead of raw text.

The endpoint is simple by design: it accepts one address line as a query parameter, with an optional two-letter country code to help interpretation. The response returns structured data that includes the key information needed for the operation, making it suitable for integrations while allowing additional fields to be added over time.

If you need to standardize addresses before comparing records or sending them into another API, Address Parser gives you a normalized starting point from a single input string.

GET
Parse and normalize address
https://api.eu.apyhub.com/dosvak/parse-and-normalize-address

QUICKSTART

GUIDE

Quickstart

Parse an address by passing the address line as a query parameter.

curl -X GET "https://api.eu.apyhub.com/dosvak/parse-and-normalize-address?address_line=1600%20Amphitheatre%20Pkwy%2C%20Mountain%20View%2C%20CA%2094043" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the original input, parsed address components, and attribution information. The response provides a standardized representation of the address that can be used directly in your application.

{
  "input": {
    "address_line": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
  },
  "parsed": {
    "house_number": "1600",
    "street": "Amphitheatre Pkwy",
    "locality": "Mountain View",
    "postal_code": "94043",
    "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

Parses and normalizes an address from the address_line query parameter, with an optional country_code hint. The response returns a structured JSON object containing the original address, parsed address components, and attribution information, making it suitable for address validation, standardization, and downstream processing.

Query Parameter(s)

AttributeTypeMandatoryDescription
address_lineStringYesAddress text to parse and normalize. Minimum length: 3 characters.
country_codeStringNoOptional country code hint. When provided, it must be a 2-character string.

Response

Returns a JSON object containing structured address components derived from the input address, along with supporting metadata for reliable storage, validation, and downstream address processing.

Query parameters

Name
Type
Description
address_lineREQUIRED
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.