apyhub
Back
▣ DATA VALIDATION · DEVELOPER TOOLS

Parse & Normalize US Address API

What it does

The Address Parsing API splits a US address line into structured fields. Send one address_line string, such as 1600 Amphitheatre Pkwy, Mountain View, CA 94043, and get back JSON with house_number, street, locality, region, postal_code, country_code, and a normalized string in a consistent comma-separated format.

Results are most reliable when the address follows the standard US order with commas: street address, then city, then state and ZIP code. The response echoes your original text under input and includes an attribution list for the open datasets behind the service (OpenAddresses, GeoNames, and Natural Earth).

Use the address parsing API to split checkout and signup addresses into separate database columns, map CRM imports onto structured fields, or build consistent keys for address deduplication. It handles parsing and normalization and keeps street text as written, so pair it with a validation service when you need to confirm an address exists.

Send the parsed fields to the Address Validation API to check them against real locations and get coordinates, or use the Address Search API to return candidate matches from a partial address. For the rest of a contact record, the Phone Number Formatter API returns numbers in E.164 and national formats. AI agents can call the address parser through ApyHub MCP to structure addresses pulled from emails or documents.

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)

AttributeTypeDescription
address_lineStringAddress text to parse and normalize. Minimum length: 3 characters.
country_codeStringOptional 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.

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

Similar APIs

Closest matches in the catalog based on this service.

CALLAddress Validation & Location Lookup APIQuadlem, LLCCALLPhone Number Formatter APIDosvak LLCCALLSearch US Address APIDosvak LLCCALLInvoice Parsing APISharpAPI

From the blog

Reads that touch this API.

Top 5 Free AI Resume Parsers for Recruiters in 2025Sep 10, 2026Revolutionizing Retail: Using AI Person Detection to Optimize Store LayoutsAug 5, 2026Exploring the world of Software Utility APIsJul 9, 2026Top Developer Skills to Learn in 2026Aug 7, 2026