{"uid":"cap_XmsZd6GaSj8KIepZMM3Hm","slug":"sitecheck-address-parse-1caa04e7","name":"SiteCheck Address Parse","description":"Splits a free-text postal address into house number, street, unit, postcode, city, district, region and country, with a normalised one-line form. The postcode is checked against the rule of the country (for 18 countries); a mismatch is left out and says so. Workers AI does the split, so check the parts. geocode=1 adds coordinates from OpenStreetMap Nominatim. Not live-checked: the owner checks the model after the merge.","url":"https://api.sitecheck-api.workers.dev/api/address/parse?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":"The address as free text, up to 500 characters"},"country":{"type":"string","description":"ISO2 code of the country when you know it, e.g. DE (optional, improves the postcode check)"},"geocode":{"type":"string","description":"1 to add coordinates from OpenStreetMap, default 0"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"model":"@cf/meta/llama-3.3-70b-instruct-fp8-fast","parts":{"city":"Berlin","unit":null,"region":null,"street":"Unter den Linden","country":"DE","district":null,"postcode":"10117","houseNumber":"77"},"source":"Workers AI split (model output) with per-country postcode rules; geocode via OpenStreetMap Nominatim when asked","geocode":null,"checkedAt":"2026-10-15T15:16:50.144Z","normalised":"Unter den Linden 77, 10117 Berlin, Germany","postcodeNote":null,"postcodeRuleChecked":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mk-AVRHD84Ks_cmiIkOV5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a free-text postal address into structured components (street, house number, postcode, city, country) with optional geocoding and postcode validation","exampleAgentPrompt":"Can you parse this address into its components — street, house number, postcode, and city — for me: 'Unter den Linden 77, 10117 Berlin'? Also add geocoordinates from OpenStreetMap.","exampleUseCases":[{"title":"Normalize user-submitted shipping address","prompt":"A customer typed '77 unter den linden berlin germany' into our checkout form — can you parse it into proper structured fields with street, house number, postcode, and city so I can store it cleanly?"},{"title":"Validate address postcode for Germany","prompt":"Can you check whether this German address is valid and the postcode matches the city: 'Marienplatz 1, 80331 München, DE'?"},{"title":"Geocode office address for mapping","prompt":"Parse '10 Downing Street, London, SW1A 2AA, UK' into structured address parts and add the GPS coordinates from OpenStreetMap so I can pin it on a map."}],"resultDescription":"A JSON object containing parsed address parts (street, houseNumber, postcode, city, region, district, country), a normalized single-line address string, the AI model used, source description, optional geocode coordinates, a postcode rule check flag and note, and a checkedAt timestamp.","failureModes":["Ambiguous or incomplete address may result in missing fields (null values for unit, region, district)","Incorrect postcode for the given city produces a postcodeNote warning","Geocode coordinates are null when geocode parameter is not set to 1","Address in unsupported or uncommon locale may degrade parsing accuracy","Very short or garbled input may return partially structured output"],"whenToPreferThis":"Use this endpoint when you need to decompose a free-text address string into structured postal components, especially for international addresses where per-country postcode rules matter. It is preferable to simple regex-based parsers because it uses an LLM for language-aware splitting and optionally validates postcodes against country rules. Choose it when you also want optional geocoding bundled in the same call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:39:59.283Z","isFirstParty":false,"canonicalSlug":"sitecheck-address-parse-1caa04e7"}