FIRST 200 OK

Use real Japan data in minutes.

Try a safe browser demo first. When you are ready to build, create a free Developer key—1,000 monthly requests, commercial use included, no credit card.

STEP 1 · ABOUT 60 SECONDS

Choose a result you want to see.

Each demo calls a constrained production experience. No account, card, API key, or Japanese typing is required.

STEP 2 · ABOUT 90 SECONDS

Create one free key.

Sign up, verify your identity, name the key, and copy it once. The full secret is never stored in plaintext and should stay in a server-side environment variable.

  1. 1

    Create the accountNo payment form for the Developer plan.

  2. 2

    Create “My first API” keyThe secret appears once.

  3. 3

    Set JAPAN_API_KEYDo not commit it or put it in browser code.

Start free — no card
STEP 3 · ABOUT 60 SECONDS

Copy, run, get HTTP 200.

Set JAPAN_API_KEY in your shell or secret manager, then use one dependency-light sample. Normal search outcomes—including not found—return a structured HTTP 200 response.

curl -X POST https://api.japanapistore.com/v1/address/resolve \
  -H "Authorization: Bearer $JAPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"〒100-0005 東京都千代田区丸の内1-1"}'

Success looks like HTTP 200 plus a request ID.The response keeps match quality, warnings, source versions, and unavailable facts visible.

KEEP BUILDING

Use the workflow you already prefer.

Continue with Postman, copy a complete Python or TypeScript client, or connect an AI agent through Japan Commerce MCP.

PostmanDeveloper kitMCP setupUse cases