{"uid":"cap_eG411Eu5C3FyhPQLLNRRZ","slug":"saylor-innovations-data-desk-us-address-normalizer-840d1073","name":"Saylor Innovations Data Desk – US Address Normalizer","description":"Standardize a free-text US address to USPS abbreviations and split it into house number, street, suffix, unit, city, state, ZIP and ZIP+4","url":"https://saylorinnovations.com/api/text/address-normalize?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"US address as free text, 6-200 characters (commas between street, city and state work best)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["normalized","components"],"properties":{"note":{"type":"string","description":"Caveat or context for reading the result"},"input":{"type":"string","description":"Address as supplied"},"line1":{"type":"string","description":"Street line with directionals, suffix and unit"},"source":{"type":"string","description":"Data source the values come from"},"complete":{"type":"boolean","description":"True when house number, street, city, state and ZIP were all found"},"warnings":{"type":"array","description":"Parts that could not be identified"},"components":{"type":"object","properties":{"zip":{"type":["string","null"],"description":"5-digit ZIP"},"city":{"type":["string","null"],"description":"City"},"unit":{"type":["string","null"],"description":"Unit of measure"},"state":{"type":["string","null"],"description":"State or region"},"zip_plus4":{"type":["string","null"],"description":"Zip plus4"},"street_name":{"type":["string","null"],"description":"Street name"},"house_number":{"type":["string","null"],"description":"House number"},"street_suffix":{"type":["string","null"],"description":"Street suffix"},"predirectional":{"type":["string","null"],"description":"Direction before the street name"},"postdirectional":{"description":"Direction after the street name"}},"description":"Component values"},"normalized":{"type":"string","description":"Single-line USPS-style address"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ys852__fzy-52jFDKI5f3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses and standardizes a free-text US address into USPS-compliant components including house number, street, suffix, unit, city, state, ZIP, and ZIP+4","exampleAgentPrompt":"Can you normalize this address to USPS format and break it into its components — house number, street, city, state, and ZIP? The address is: 1600 Pennsylvania Avenue NW, Washington DC 20500","exampleUseCases":[{"title":"Standardize customer shipping address","prompt":"I need to clean up this shipping address before storing it — can you parse '742 Evergreen Terrace Springfield IL 62704' into its individual components and give me the USPS-standard version?"},{"title":"Validate e-commerce checkout address","prompt":"A customer typed '45 W 34th St Apt 3B New York New York 10001' at checkout — can you normalize it to USPS abbreviations and tell me if it's a complete, valid address with all required parts?"},{"title":"Extract ZIP+4 for bulk mail presort","prompt":"I need the ZIP+4 for this address: '1 Infinite Loop, Cupertino, CA 95014' — can you parse it out and give me the full USPS breakdown including the four-digit extension?"}],"resultDescription":"Returns a JSON object containing: a single-line normalized address string, structured components (house_number, street_name, street_suffix, predirectional, postdirectional, unit, city, state, zip, zip_plus4), a boolean 'complete' flag indicating whether all key parts were found, any warnings about unrecognized parts, the original input string, and the data source used.","failureModes":["Address too short or too long (outside 6-200 character range) returns validation error","Non-US addresses cannot be parsed and will return incomplete results or errors","Highly ambiguous or malformed addresses may return incomplete=false with warnings","Missing ZIP code in input may result in null zip and zip_plus4 fields","Street suffix not recognized may appear in warnings array"],"whenToPreferThis":"Choose this endpoint when you need to standardize US postal addresses to USPS format and extract structured components from free-text input. It is purpose-built for US addresses and returns granular field-level decomposition including ZIP+4, making it ideal for data cleaning pipelines, form validation, mail presort, or database normalization. Prefer this over generic geocoding APIs when you need structured postal components rather than coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:54:04.807Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-us-address-normalizer-840d1073"}