# Kanshudo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_100_most_frequent_kanji_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_jlpt_kanji_collection \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_kanji_by_component \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_kanji_collections_index \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_kanji_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_kanji_stroke_order \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/get_word_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kanshudo-com-api-f0097c30/search_kanji \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```