# Kanshudo — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and explore kanji characters and Japanese words with detailed educational information like stroke order, JLPT levels, and component breakdowns. Browse curated kanji collections, look up specific characters, and discover the most frequently used kanji in Japanese.

**Category:** Education | **Website:** [kanshudo.com/](https://kanshudo.com/) | **Docs:** [parse.bot/marketplace/f0097c30-34ca-4761-9651-ef5b4b770106/kanshudo-com-api](https://parse.bot/marketplace/f0097c30-34ca-4761-9651-ef5b4b770106/kanshudo-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get 100 most frequent kanji list

Retrieves the 100 most frequently used kanji characters from Kanshudo's frequency ranking. Returns an ordered array of single kanji character strings. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-100-most-frequent-kanji-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get jlpt kanji collection

Retrieves all kanji characters classified at a specific JLPT proficiency level. Returns the level queried and an array of kanji character strings for that level. Coverage: N5 (~80 kanji) through N1 (~1200 kanji).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `level` | string | Yes | JLPT level |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-jlpt-kanji-collection \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"level":"<string>"}'
```

### Get kanji by component

Finds kanji characters that contain a specific component or radical by searching Kanshudo. Returns the component queried and an array of kanji characters found in the search results that match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `component` | string | Yes | A kanji component or radical character (e.g. "人") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-kanji-by-component \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"component":"<string>"}'
```

### Get kanji collections index

Retrieves the full index of available kanji and word study collections on Kanshudo, including JLPT-organized sets, textbook-aligned sets (Genki, Japanese for Busy People), thematic collections (countries, names), and frequency-based sets.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-kanji-collections-index \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get kanji detail

Fetches detailed information for a single kanji character including on/kun readings, English meaning, usage stats (strokes, radical number, frequency rank, JLPT level), stroke order SVG, and example compound words with readings and meanings. The stats object keys vary by kanji.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `kanji` | string | Yes | A single kanji character (e.g. "人") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-kanji-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"kanji":"<string>"}'
```

### Get kanji stroke order

Constructs stroke order resource URLs for a kanji character from its Unicode code point. Returns the S3-hosted SVG stroke diagram URL and Kanshudo animation page link. No network request is made; URLs are deterministically generated.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `kanji` | string | Yes | A single kanji character (e.g. "人") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-kanji-stroke-order \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"kanji":"<string>"}'
```

### Get word detail

Fetches detailed information for a specific Japanese word including its hiragana reading, English meaning, and kanji component breakdown showing individual characters and radicals composing the word.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | A Japanese word in kanji or kana (e.g. "外国人") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/get-word-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### Search kanji

Full-text search across Kanshudo's kanji and word database. Query can be English meaning or Japanese text. Returns mixed results: kanji results have kanji/readings/meaning fields; word results have word/reading/meaning/type fields. Results are not paginated; the server returns a single page of top matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (English meaning or Japanese text, e.g. "water" or "水") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kanshudo/search-kanji \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.