Overview
Smarty's US Extract API scans any block of unstructured text — emails, documents, web pages — and extracts all US postal addresses it finds, then validates each one against USPS data for deliverability. This is especially useful for parsing contact information from email bodies, CRM notes, or legacy data without structured address fields. The free plan includes a limited number of extractions per month.
Beginner Tip
Sign up at smarty.com for an API key and secret. The endpoint is `https://us-extract.api.smarty.com/` with a POST request containing the text in the body. Authentication uses `auth-id` and `auth-token` as query parameters. Each block of text submitted counts as one lookup regardless of how many addresses are found inside it.
Available Data
The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.
Example Response
Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.
{
"message_id": "msg_abc123def456",
"status": "delivered",
"to": "[email protected]",
"subject": "Welcome!",
"timestamp": "2025-01-15T10:30:00Z"
} Field Reference
meta Metadata about the extraction including `lines`, `unicode`, `address_count`, and `verified_count`. addresses Array of address objects found in the submitted text. addresses[].verified Whether the extracted address was validated as deliverable by USPS data. addresses[].text The raw address text as it appeared in the original input. addresses[].api_output Array of verification result objects (same format as US Street Address API output) for each extracted address. addresses[].api_output[].deliverability USPS deliverability status for this extracted address. Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://us-extract.api.smarty.com/?auth-id=YOUR_AUTH_ID&auth-token=YOUR_AUTH_TOKEN";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
Technical Specifications
Related Tags
Similar APIs
View All →Lob.com
Lob.com provides a US Address Verification API that validates, standardizes, and geocodes US mailing addresses using USPS data, ensuring mail deliverability and cleaning up address databases.
US Autocomplete
Smarty's US Autocomplete Pro API provides real-time US address suggestions as users type, returning up to 10 valid USPS-deliverable address candidates per query to reduce data entry errors and speed up checkout flows.
US Street Address
The Smarty US Street Address API validates and enriches US postal addresses in real time, returning standardized components like delivery line, city, state, ZIP+4, and county FIPS code.
VATlayer
VATlayer is a REST API for validating EU VAT numbers in real time against official EU VIES (VAT Information Exchange System) data, returning company name, address, and registration status.
Postman Echo
⭐ Beginner's PickPostman Echo is a free HTTP test server that mirrors back exactly what you send — headers, query parameters, body, cookies, and request method — making it invaluable for debugging API clients and understanding HTTP behavior without needing a real backend.