{"uid":"cap_dqn1EA-Ow6e0blPSlGTFd","slug":"japan-address-api-parse-normalize-59630b64","name":"Japan Address API — Parse & Normalize","description":"Extract a fully structured Japanese (JP) address — prefecture, city, town, chome-banchi, plus building name, room number and addressee — from free-form, OCR, or voice-transcribed text. Use to turn one messy line into typed fields for invoices, shipping labels, or CRM records.","url":"https://address.agentic-jp.com/parse","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","maxLength":2000,"description":"Free-form text (OCR / voice transcript) containing a Japanese address"}}},"responseSchema":{"type":"json","example":{"address":{"room":"1234号室","building":"衆議院第二議員会館","normalized":"東京都千代田区永田町1-7-1"},"addressee":{"name":"田中太郎","honorific":"様"},"confidence":0.85}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_J-kaZHLv74UjZnE-Ztsuy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses, normalizes, geocodes, and reverse-geocodes Japanese addresses, with postal-code lookup and confidence scoring, billed per call in USDC via x402.","exampleAgentPrompt":"Can you parse and normalize this Japanese address for me — '東京都千代田区永田町1-7-1 衆議院第二議員会館1234号室 田中太郎様' — and tell me how confident you are in the result?","exampleUseCases":[{"title":"E-commerce shipping address cleanup","prompt":"I have a customer-submitted Japanese shipping address '東京都渋谷区道玄坂２−２−１ ヒカリエビル 301号室' that looks messy — can you normalize it and confirm whether it's a valid deliverable address with a confidence score?"},{"title":"Postal code to address lookup","prompt":"Can you look up the Japanese address for postal code 100-8961 and give me the normalized address components including any building name?"},{"title":"Addressee and address extraction from a letter","prompt":"I have this Japanese letter header text: '〒100-0014 東京都千代田区永田町1-7-1 田中太郎 様' — please parse out the addressee name with honorific and the normalized address separately."}],"resultDescription":"A JSON object containing: a parsed address object with normalized address string, building name, and room number; an addressee object with name and honorific; and a floating-point confidence score (0–1) reflecting how reliably the input was parsed.","failureModes":["Unparseable input returns low confidence score or partial fields","Non-Japanese addresses may fail or return garbage results","Malformed postal codes may return no match","Ambiguous address strings may yield lower confidence scores","Network or payment failure returns HTTP error before processing"],"whenToPreferThis":"Choose this endpoint when you need to handle Japanese-language addresses specifically — parsing kanji/kana address strings, validating Japanese postal codes, extracting structured components (building, room, addressee), or normalizing for mail delivery. It is pay-per-call with no API key required, making it ideal for low-volume or agent-driven workflows that need on-demand Japanese address intelligence without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:02.777Z","isFirstParty":false}