{"uid":"cap_l11VhxW5kuK7vt5z-dY3L","slug":"ja-normalize-japanese-address-normalization-9b721a25","name":"ja-normalize: Japanese Address Normalization","description":"Calendar and Japan data APIs for AI agents: worldwide holidays and business days (200+ countries), plus Japanese text-to-structure (address, name, bank, company normalization). Pay per call in USDC via x402, no API key.","url":"https://x402-ja-api.onrender.com/v1/address/normalize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"level":{"enum":[1,2,3,8],"type":"integer","default":8,"description":"Max normalization depth"},"address":{"type":"string","maxLength":200,"description":"Japanese address in any notation"}}},"responseSchema":{"type":"json","example":{"addr":"1-1","city":"千代田区","pref":"東京都","town":"千代田","input":"東京都千代田区千代田１−１","level":8,"other":"","point":{"lat":35.68,"lng":139.75,"level":8},"formatted":"東京都千代田区千代田1-1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mMtu162b9GQp1mR8FI3i1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses and normalizes a Japanese address string into structured components (prefecture, city, town, street number) with geocoordinates","exampleAgentPrompt":"Can you parse this Japanese address '東京都千代田区千代田１−１' into structured fields like prefecture, city, town, and street number, and also give me the lat/lng coordinates? Use full normalization depth (level 8).","exampleUseCases":[{"title":"E-commerce shipping address cleanup","prompt":"I have a customer-submitted Japanese address '大阪府大阪市北区梅田１丁目３−１−２００' that might be messily formatted — can you normalize it into clean structured fields (prefecture, city, town, street) with coordinates so I can store it properly in our shipping database? Use full normalization depth."},{"title":"Real estate geocoding pipeline","prompt":"I need to geocode this Japanese address for a property listing: '神奈川県横浜市中区山下町１'. Can you break it down into structured components and give me the latitude and longitude? Use level 8 normalization."},{"title":"Address-level data deduplication","prompt":"We have two address strings that might refer to the same location: '東京都新宿区西新宿2-8-1' and '東京都新宿区西新宿２丁目８番１号'. Can you normalize both to their structured canonical forms using full normalization so I can compare them?"}],"resultDescription":"A JSON object containing: parsed prefecture (pref), city, town, and street/block number (addr), a formatted canonical address string, the original input, normalization level achieved, any unparsed remainder (other), and a point object with latitude, longitude, and the confidence level of the geocoordinate.","failureModes":["Address too ambiguous or incomplete — returns lower normalization level than requested","Non-Japanese or romanized address input yields poor parse quality","Very rural or recently renamed addresses may not resolve fully","Service unavailable on Render free tier due to cold start or sleep (timeout)","Insufficient USDC balance or x402 payment failure returns 402 error"],"whenToPreferThis":"Use this endpoint when you need to parse, normalize, or geocode Japanese-language address strings into structured machine-readable components. It is specifically designed for Japanese address notation (kanji, kana, numeric mixed formats) and returns both structured fields and geocoordinates in a single call. Prefer this over generic geocoding APIs when the input is in Japanese and you need prefecture/city/town decomposition alongside coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:10.460Z","isFirstParty":false}