{"uid":"cap_GR7dhGyxKH2yn9_7LJUgh","slug":"japanese-name-parser-ja-normalize-c8c72b16","name":"Japanese Name Parser (ja-normalize)","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/jp/name/parse","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":["name"],"properties":{"kana":{"type":"string","maxLength":100,"description":"Optional known reading \"<family kana> <given kana>\" — makes readings and romaji deterministic"},"name":{"type":"string","maxLength":40,"description":"Full name in kanji, e.g. 山田太郎 (a space between family and given name is honoured)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"given":{"kanji":"裕子","readings":[{"kana":"ゆうこ","score":0.86,"source":"dictionary"},{"kana":"ひろこ","score":0.86,"source":"dictionary"},{"kana":"のぶこ","score":0.78,"source":"dictionary"}],"confidence":"medium"},"input":"佐藤裕子","notes":["given-name reading is ambiguous; candidates are ordered by likelihood — pass `kana` when known"],"split":{"method":"dictionary","confidence":0.95},"family":{"kanji":"佐藤","readings":[{"kana":"さとう","score":0.97,"source":"dictionary"}],"confidence":"high"},"romaji":{"basis":"best-guess","given":"YUKO","family":"SATO","western":"Yuko Sato","passport":"SATO YUKO"}}},"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_nsbwWopCtZttjPRiXg32C","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 a Japanese full name in kanji into family and given name segments, with kana readings, confidence scores, and romanized forms including passport-format.","exampleAgentPrompt":"Can you parse the Japanese name 佐藤裕子 into its family and given name parts, give me the most likely kana readings, and show me how it would appear on a passport?","exampleUseCases":[{"title":"Passport romanization for travel booking","prompt":"I need to fill out a travel form for our employee — her name in kanji is 田中美咲. Can you split it into family and given name and give me the passport-format romanization?"},{"title":"CRM data normalization for Japanese contacts","prompt":"We have a Japanese customer whose name is stored as 鈴木一郎 in our system. Can you parse that into surname and given name and give me the Western-order English spelling so I can update our CRM?"},{"title":"Disambiguating ambiguous name readings","prompt":"I have a name 中村翔 and I know the reading is ナカムラ ショウ — can you parse it and confirm the kana breakdown and romaji with that reading provided?"}],"resultDescription":"Returns a JSON object containing the split family and given name in kanji, an array of candidate kana readings for each part with likelihood scores and source labels, an overall confidence level (high/medium/low), the method used to split the name, romaji in multiple formats (western order, passport ALLCAPS), and any notes about ambiguity in reading.","failureModes":["Missing required 'name' query parameter returns an error","Non-Japanese or non-kanji input may produce low-confidence or failed splits","Very short or single-character names may not split reliably","Highly ambiguous names with many possible readings will return medium/low confidence and multiple candidates","Payment not included or insufficient USDC results in HTTP 402 payment required"],"whenToPreferThis":"Use this endpoint when you need to split a Japanese full name written in kanji into its constituent family and given name parts, obtain kana readings (including disambiguation), or produce passport-format romanization. It is specifically optimized for Japanese person names, unlike general-purpose NLP or translation APIs. Prefer this over character-by-character transliteration tools when dictionary-backed reading confidence scores and split detection are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:30:45.214Z","isFirstParty":false}