# Japan Furigana API — Name Readings

> Japan Furigana API — Name Readings is a paid API for AI agents from furigana.agentic-jp.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns multiple candidate readings (hiragana and romaji) with probability scores for a Japanese name written in kanji

## Facts

- Endpoint: POST https://furigana.agentic-jp.com/name-readings
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-furigana-api-name-readings-86b44fac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1oQ9NmI5aU_1HlK8-b5pb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability japan-furigana-api-name-readings-86b44fac -d '<json body>'
```

Example prompt: What are all the possible readings for the Japanese name 山崎太郎 in both romaji and hiragana, with probabilities for each?

## When to prefer this

Use this endpoint when you need phonetic readings of Japanese proper names written in kanji, especially when multiple valid readings exist and you want ranked probability candidates. Ideal for name disambiguation, form auto-fill, pronunciation guides, or romanization of person names in Japanese databases. Prefer this over a general furigana endpoint when the input is specifically a personal name rather than general Japanese text.

## Known failure modes

- Non-Japanese or non-kanji input may return low confidence or empty candidates
- Rare or unusual kanji combinations may yield low probability scores
- Payment failure via x402 returns a 402 Payment Required error before processing
- Malformed or empty input string returns a validation error
- Names with extremely common kanji that have many readings may return low individual probabilities

## How this service works

List the possible readings of a Japanese (JP) name — person, company, or place — each with a probability, since names like 山崎 (やまざき / やまさき) are ambiguous without context. Returns hiragana, katakana, and romaji per candidate. Use for CRM name-matching, furigana fields, and call-list preparation.

## Output

A JSON object containing the input name, a list of candidate readings each with hiragana and romaji representations and a probability score, plus an overall confidence value. For example, 山崎太郎 might return Yamazaki Taro (68%) and Yamasaki Taro (32%) as candidates with a confidence of 0.85.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "maxLength": 200,
   "description": "A Japanese name (person/company/place)"
  },
  "name_type": {
   "enum": [
    "person",
    "company",
    "place"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "input": "山崎太郎",
  "candidates": [
   {
    "probability": 0.68,
    "reading_romaji": "Yamazaki Taro",
    "reading_hiragana": "やまざきたろう"
   },
   {
    "probability": 0.32,
    "reading_romaji": "Yamasaki Taro",
    "reading_hiragana": "やまさきたろう"
   }
  ],
  "confidence": 0.85
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-furigana-api-name-readings-86b44fac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from furigana.agentic-jp.com](https://www.zero.xyz/host/furigana.agentic-jp.com/llms.txt)