Dictionary

Search entries

GET/v1/dictionary/{lang}/entries

Case-insensitive across headword prefix, spelling, inflected surface form, and (jpn) reading. Ordered by relevance: an exact headword or spelling, then an exact inflected surface or reading, then the prefix matches, each rank ordered by frequency, the most frequent first and the unranked last.

Parameters

lang"eng" | "jpn"requiredpath

Language of the entries

querystringquery

Search query. Without it the page is the headword list in headword order

afterstringquery

Cursor from metadata.after for the next page

beforestringquery

Cursor from metadata.before for the previous page

limitintegerquery

Results per page, capped at 25

Response200`DictionaryEntriesPage`

entriesDictionaryEntry[]required

DictionaryEntry

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

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

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

metadataobjectrequired

metadata.afterstringrequirednullable

Cursor for the next page; null on the last

metadata.beforestringrequirednullable

Cursor for the previous page; null on the first

metadata.limitintegerrequired

The page size that was applied

Errors

Status	Code	When
401	`unauthorizedapi_key_invalidapi_key_revokedapi_key_suspended`	No key, or a key that is invalid, revoked or suspended.
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?query=%E3%81%9F%E3%81%B9&limit=3' \
  -H "Authorization: Bearer $IMMIT_API_KEY"

200 · captured · abridged

{
  "metadata": {
    "after": null,
    "before": null,
    "limit": 3
  },
  "entries": [
    {
      "id": "9bebf0ab-36ee-4511-a271-f8d0a21efe31",
      "headword": "食べる",
      "lang": "jpn",
      "frequency_rank": 293,
      // … the full entry
    },
    {
      "id": "9323df1f-0ad8-4b00-9e7c-275da917e3d4",
      "headword": "たべっ子どうぶつ",
      "lang": "jpn",
      "frequency_rank": 107140,
      // … the full entry
    },
    {
      "id": "c7c50b63-cd93-4a09-9c9e-b737df9cccec",
      "headword": "食べつわり",
      "lang": "jpn",
      "frequency_rank": 160361,
      // … the full entry
    }
  ]
}

Try it · runs against api.immit.co

Search entries

GET/v1/dictionary/{lang}/entries

Parameters

lang"eng" | "jpn"requiredpath

Language of the entries

querystringquery

Search query. Without it the page is the headword list in headword order

afterstringquery

Cursor from metadata.after for the next page

beforestringquery

Cursor from metadata.before for the previous page

limitintegerquery

Results per page, capped at 25

Response200DictionaryEntriesPage

entriesDictionaryEntry[]required

DictionaryEntry

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

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

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

metadataobjectrequired

metadata.afterstringrequirednullable

Cursor for the next page; null on the last

metadata.beforestringrequirednullable

Cursor for the previous page; null on the first

metadata.limitintegerrequired

The page size that was applied

Errors

Status	Code	When
401	`unauthorizedapi_key_invalidapi_key_revokedapi_key_suspended`	No key, or a key that is invalid, revoked or suspended.
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.

{ "metadata": { "after": null, "before": null, "limit": 3 }, "entries": [ { "id": "9bebf0ab-36ee-4511-a271-f8d0a21efe31", "headword": "食べる", "lang": "jpn", "frequency_rank": 293, // … the full entry }, { "id": "9323df1f-0ad8-4b00-9e7c-275da917e3d4", "headword": "たべっ子どうぶつ", "lang": "jpn", "frequency_rank": 107140, // … the full entry }, { "id": "c7c50b63-cd93-4a09-9c9e-b737df9cccec", "headword": "食べつわり", "lang": "jpn", "frequency_rank": 160361, // … the full entry } ] }

Parameters

Response200DictionaryEntriesPage

Errors

Parameters

Response200DictionaryEntriesPage

Errors

Try it · runs against api.immit.co

Response200`DictionaryEntriesPage`

Response200`DictionaryEntriesPage`