SAKANA KANA PRIMITIVES API // v1.0

RESTONLINE

Kana Primitives API Overview

The SaKana Public REST API exposes structured Japanese Hiragana and Katakana phonetic datasets. Developers can query characters, romaji transliterations, phonetic classifications (gojūon, dakuon, handakuon, yōon), mnemonic hints, and native audio pronunciation files.

Base Endpoint

/api/v1/kana

Authentication

None (Public GET)

Audio Delivery

Pre-rendered Voicevox (.wav)

GET/api/v1/kana

Retrieve Kana Primitives

Query Parameters

Param	Type	Values	Description
script	string	hiragana \| katakana	Filter by script family.
type	string	gojuon \| dakuon \| handakuon \| yoon	Phonetic category filter.
minimal	boolean	true \| false	When `true`, omits hints & audio for lightweight payloads.

Integration Code Snippets

cURL Request

# Fetch Hiragana gojuon characters with default audio URLs
curl -X GET "https://sakanajp.site/api/v1/kana?script=hiragana&type=gojuon"

JavaScript / TypeScript Fetch

// Fetch kana primitives in JavaScript / TypeScript
const res = await fetch("/api/v1/kana?script=hiragana&type=gojuon");
const { data } = await res.json();

data.forEach((k) => {
  console.log(`${k.character} (${k.romaji}) -> audio: ${k.audioUrl}`);
});

Live Interactive API Explorer

TEST BENCH

Script

Type

Minimal Mode

Live Response Output:

// Click 'Execute Request' above to test the live API endpoint in real-time.

Standard Response Schema

{
  "success": true,
  "count": 46,
  "data": [
    {
      "id": "h-a",
      "character": "あ",
      "romaji": "a",
      "script": "hiragana",
      "type": "gojuon",
      "row": "vowel",
      "hint": "Looks like an apple with a stem.",
      "audioUrl": "/audio/kana/h-a.wav"
    },
    ...
  ]
}

Return to DashboardSaKana Public REST API v1.0 • JSON output • Voicevox Audio