# Japan Address API — Parse & Normalize

> Japan Address API — Parse & Normalize is a paid API for AI agents from address.agentic-jp.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Parses, normalizes, geocodes, and reverse-geocodes Japanese addresses, with postal-code lookup and confidence scoring, billed per call in USDC via x402.

## Facts

- Endpoint: POST https://address.agentic-jp.com/parse
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-address-api-parse-normalize-59630b64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dqn1EA-Ow6e0blPSlGTFd

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-address-api-parse-normalize-59630b64 -d '<json body>'
```

Example prompt: Can you parse and normalize this Japanese address for me — '東京都千代田区永田町1-7-1 衆議院第二議員会館1234号室 田中太郎様' — and tell me how confident you are in the result?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "maxLength": 2000,
   "description": "Free-form text (OCR / voice transcript) containing a Japanese address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "address": {
   "room": "1234号室",
   "building": "衆議院第二議員会館",
   "normalized": "東京都千代田区永田町1-7-1"
  },
  "addressee": {
   "name": "田中太郎",
   "honorific": "様"
  },
  "confidence": 0.85
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-address-api-parse-normalize-59630b64/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from address.agentic-jp.com](https://www.zero.xyz/host/address.agentic-jp.com/llms.txt)