Developers
OverviewDocsReferencePricingChangelog
Log inGet an API keyConsole
immit Developers

English and Japanese in one entry shape, over one REST API.

All systems normal

Product

  • Overview
  • Pricing
  • Changelog
  • Console

Docs

  • Getting started
  • API reference
  • openapi.yaml
  • llms.txt

Company

  • immit.co
  • Support
  • API terms
  • Privacy Policy
Techbient LLC 2026. All rights reserved
Console
  • Introduction

Dictionary

  • GETSearch entries
  • GETGet an entry

Account

  • GETThe calling key

Files

  • openapi.yaml
  • llms-full.txt
  • Changelog
Dictionary

Get an entry

GET/v1/dictionary/{lang}/entries/{headword}

Exact match on (lang, headword), then two fallbacks: a headword that differs from an entry only in case resolves to that entry, and a written form among an entry's spellings resolves to that entry (its canonical headword is in the response). The headword is UTF-8, percent-encoded — no fuzzy matching beyond case and spellings.

Parameters

lang"eng" | "jpn"requiredpath
Language of the entry
headwordstringrequiredpath
The headword, percent-encoded: 食べる is %E9%A3%9F%E3%81%B9%E3%82%8B on the wire

Response200DictionaryEntry

idstring · uuidrequired
headwordstringrequired
The canonical headword. A case variant or a spelling in the request resolves to it
lang"eng" | "jpn"required
frequency_rankintegerrequirednullable
1 is the most frequent entry of its language; null when unranked
updated_atstring · date-timerequired
When the entry last changed; the entry's ETag is derived from it
inflectionsDictionaryInflection[]required
Every form as a row, so a client never deinflects
DictionaryInflection
idstring · uuidrequired
formstringrequired
The form name in the entry's language: て形, past tense
textstringrequired
The surface form: 食べて, walked
homographintegerrequired
polarity"positive" | "negative"requirednullable
Set on Japanese forms and on a few English negative forms; null elsewhere
tone"plain" | "polite"requirednullable
Japanese only; null on English rows
posstringrequired
form_translationsobjectrequired
form_translations.engstringnullable
form_translations.jpnstringnullable
form_sequenceintegerrequired
Display order of the form within the entry's table
pronunciationsDictionaryInflectionPronunciation[]required
The reading of this form; usually empty on English rows
DictionaryInflectionPronunciation
idstring · uuidrequired
ipastringrequirednullable
IPA on English rows; usually an empty string on Japanese rows
readingstringrequirednullable
Kana reading on Japanese rows; null on English rows
dialectstringrequirednullable
AmE on English rows; null on Japanese rows
accentintegerrequirednullable
Pitch accent, Japanese only: the mora after which the pitch drops, 0 for heiban
soundsDictionaryInflectionSound[]required
DictionaryInflectionSound
idstring · uuidrequired
keystringrequired
The storage key behind the URL
mp3_urlstringrequired
Playable as is, and cacheable
voicestringrequired
Himari, Emma or Michael
gender"male" | "female"required
alphabet"ipa" | "phonetic"required
sensesDictionarySense[]required
DictionarySense
idstring · uuidrequired
posstringrequired
Part of speech in the entry's language: verb, 動詞
definitionstringrequired
In the entry's own language
translationsDictionaryTranslationsrequired
DictionaryTranslations
{key}object
{key}.glossesobject[]required
{key}.glosses[].idstring · uuidrequired
{key}.glosses[].textstringrequired
{key}.glosses[].readingsstring[]
Kana readings of a Japanese gloss; empty when unknown
{key}.qualifierobjectrequirednullable
A domain or register, such as 野球 on a baseball sense
{key}.qualifier.idstring · uuidrequired
{key}.qualifier.textstringrequired
examplesDictionaryExample[]required
Parallel sentence pairs, one sentence per language
DictionaryExample
idstring · uuidrequired
sentencesDictionaryExampleSentence[]required
DictionaryExampleSentence
idstring · uuidrequired
lang"eng" | "jpn"required
textstringrequired
homographintegerrequired
Which homograph of the headword the sense belongs to
pos_translationsobjectrequired
pos_translations.engstringnullable
pos_translations.jpnstringnullable
pronunciationsDictionaryPronunciation[]required
DictionaryPronunciation
idstring · uuidrequired
homographintegerrequired
ipastringrequirednullable
IPA on English rows; usually an empty string on Japanese rows
readingstringrequirednullable
Kana reading on Japanese rows; null on English rows
dialectstringrequirednullable
AmE on English rows; null on Japanese rows
accentintegerrequirednullable
Pitch accent, Japanese only: the mora after which the pitch drops, 0 for heiban
soundsDictionarySound[]required
DictionarySound
idstring · uuidrequired
keystringrequired
The storage key behind the URL
mp3_urlstringrequired
Playable as is, and cacheable
voicestringrequired
Himari, Emma or Michael
gender"male" | "female"required
alphabet"ipa" | "phonetic"required
relationsDictionaryRelation[]
Always served. Not required, because a device parses entries stored before the field existed
DictionaryRelation
sense_idstring · uuidrequired
homographintegerrequired
posstringrequired
kindstringrequired
synonym or antonym; more kinds can follow
headwordstringrequired
entry_idstring · uuidrequired
spellingsDictionarySpelling[]
Always served. Not required, because a device parses entries stored before the field existed
DictionarySpelling
homographintegerrequired
textstringrequired
Another written form of the same word: 喰べる for 食べる
labelstringrequired
What the spelling is beside the headword, in the entry's language
label_translationsobjectrequired
label_translations.engstringnullable
label_translations.jpnstringnullable
inflection_textsstring[]required
The texts that inflect this spelling: lookup surfaces with no form

Errors

StatusCodeWhen
401
unauthorizedapi_key_invalidapi_key_revokedapi_key_suspended
No key, or a key that is invalid, revoked or suspended.
404
not_found
No entry, spelling or case variant matches.
429
rate_limitedquota_exceeded
The burst or the day is used. Read retry-after.
422
invalid_param
A parameter outside its type: a lang that is not eng or jpn, a limit that is not an integer.
curl 'https://api.immit.co/v1/dictionary/jpn/entries/%E9%A3%9F%E3%81%B9%E3%82%8B' \
  -H "Authorization: Bearer $IMMIT_API_KEY"
200 · captured · abridged
{
  "id": "9bebf0ab-36ee-4511-a271-f8d0a21efe31",
  "headword": "食べる",
  "lang": "jpn",
  "frequency_rank": 293,
  "updated_at": "2026-10-09T05:40:29.465156Z",
  "pronunciations": [
    {
      "id": "a92a963c-34c2-4cb4-ac3a-c992795b62d6",
      "homograph": 1,
      "reading": "たべる",
      "ipa": "",
      "accent": 2,
      "dialect": null,
      "sounds": [
        {
          "mp3_url": "https://storage.immit.co/sounds/01M45PR236JEQ21RS26407FZ32.mp3",
          "voice": "Himari",
          "gender": "female",
          "alphabet": "phonetic",
          // … id, key
        }
      ]
    }
  ],
  "spellings": [
    {
      "homograph": 1,
      "text": "喰べる",
      "label": "まれな漢字",
      "label_translations": {
        "eng": "rare kanji"
      },
      "inflection_texts": [
        "喰べ",
        // … 37 more texts
      ]
    }
  ],
  "senses": [
    {
      "id": "b7081c6b-11d7-4980-b1dd-99d330e03dad",
      "homograph": 1,
      "pos": "動詞",
      "pos_translations": {
        "eng": "verb"
      },
      "definition": "食物を口に入れ、かんで飲み込む。",
      "translations": {
        "eng": {
          "qualifier": null,
          "glosses": [
            {
              "text": "to eat",
              "readings": []
            },
            {
              "text": "to have (a meal)",
              "readings": []
            }
          ]
        }
      },
      "examples": [
        {
          "sentences": [
            {
              "lang": "eng",
              "text": "I try to eat vegetables every day.",
              // … id
            },
            {
              "lang": "jpn",
              "text": "毎日野菜を食べるようにしている。",
              // … id
            }
          ],
          // … id
        },
        // … 2 more examples
      ]
    },
    // … 1 more sense
  ],
  "inflections": [
    {
      "text": "食べる",
      "form": "現在形",
      "form_translations": {
        "eng": "present"
      },
      "tone": "plain",
      "polarity": "positive",
      "pronunciations": [
        {
          "reading": "たべる",
          // …
        }
      ],
      // … id, pos, homograph, form_sequence
    },
    {
      "text": "食べます",
      "form": "現在形",
      "form_translations": {
        "eng": "present"
      },
      "tone": "polite",
      "polarity": "positive",
      "pronunciations": [
        {
          "reading": "たべます",
          // …
        }
      ],
      // … id, pos, homograph, form_sequence
    },
    {
      "text": "食べない",
      "form": "現在形",
      "form_translations": {
        "eng": "present"
      },
      "tone": "plain",
      "polarity": "negative",
      "pronunciations": [
        {
          "reading": "たべない",
          // …
        }
      ],
      // … id, pos, homograph, form_sequence
    },
    // … 40 more rows
  ],
  "relations": [
    {
      "sense_id": "b7081c6b-11d7-4980-b1dd-99d330e03dad",
      "kind": "synonym",
      "headword": "食う",
      "entry_id": "d2bf0807-33aa-434b-bfb0-d1b3ba4b2444",
      "homograph": 1,
      "pos": "動詞"
    },
    {
      "sense_id": "b7081c6b-11d7-4980-b1dd-99d330e03dad",
      "kind": "synonym",
      "headword": "召し上がる",
      "entry_id": "d625a5e9-5d64-4f01-994c-f11dcf4820e9",
      "homograph": 1,
      "pos": "動詞"
    },
    // … 3 more relations
  ]
}

Try it · runs against api.immit.co

GETSearch entries
GETGet an entry
GETThe calling key

Try it · runs against api.immit.co

Sign in to pick one of your keys, or paste one. Leave it empty to see the 401.

curl 'https://api.immit.co/v1/dictionary/jpn/entries/%E9%A3%9F%E3%81%B9%E3%82%8B'