Dictionary

Word Lookup

0calls
2 credits / call

Want to add a word lookup feature to your vocabulary app, reading plugin, or chatbot? Pass one English word and instantly get a detailed "mini dictionary".

GET
uapis.cn
/api/v1/dictionary/lookup
Query parameters
3
word
string
required

The English word to look up, up to 64 characters.

lang
string

Target language. Currently supports en only (default).

engine
string

Lookup engine. Set to local for low-latency mode. Leave it unset to use the default lookup.

Overview

Pass the English word you want to look up, and the endpoint returns a comprehensive entry. The structure is highly dynamic — if a word has no common phrases or synonyms, those fields are simply omitted so the frontend can render leanly.

What's Returned

  • Phonetics & pronunciation (phonetics): UK and US phonetics, plus pronunciation audio URLs you can play directly on the frontend.
  • Chinese definitions (definitions): translations grouped by part of speech.
  • English definitions (english_definitions): native English explanations with short examples.
  • Word forms (word_forms): plural, past tense, comparative, and other inflections.
  • Phrases & synonyms (phrases / synonyms): common collocations and synonyms grouped by part of speech.
  • Bilingual examples (examples): English-Chinese example sentences in real context.

Query parameters

word
stringrequired

The English word to look up, up to 64 characters.

lang
stringoptional

Target language. Currently supports en only (default).

engine
stringoptional

Lookup engine. Set to local for low-latency mode. Leave it unset to use the default lookup.

Response

200 / OK

Lookup succeeded; returns the full word entry.

JSON
{
  "found": true,
  "entry": {
    "word": "present",
    "language": "en",
    "phonetics": {
      "uk": {
        "text": "prɪˈzent",
        "audio": "/api/v1/dictionary/audio?word=present&accent=uk"
      },
      "us": {
        "text": "prɪˈzent",
        "audio": "/api/v1/dictionary/audio?word=present&accent=us"
      }
    },
    "exam_tags": [
      "string"
    ],
    "definitions": [
      {
        "part_of_speech": "n.",
        "meaning": "现在,目前;礼物,赠品"
      }
    ],
    "english_definitions": [
      {
        "part_of_speech": "n.",
        "definition": "the period of time that is happening now",
        "examples": [
          "string"
        ]
      }
    ],
    "word_forms": [
      {
        "name": "过去式",
        "value": "presented"
      }
    ],
    "phrases": [
      {
        "phrase": "at present",
        "meaning": "目前,现在"
      }
    ],
    "synonyms": [
      {
        "part_of_speech": "adj.",
        "meaning": "现在的;出席的",
        "words": [
          "string"
        ]
      }
    ],
    "examples": [
      {
        "source": "Did you get your mother a present?",
        "translation": "给你母亲买礼物了吗?"
      }
    ]
  }
}

400 / Bad Request

Invalid parameters, e.g. empty word or exceeding the maximum length limit.

404 / Not Found

No definition found for the word, possibly due to a misspelling or it not being in the corpus yet.

JSON
{
  "code": "WORD_NOT_FOUND",
  "message": "No definition found for the word"
}

502 / Bad Gateway

The lookup service is temporarily unavailable. Please retry later.

JSON
{
  "code": "SERVICE_UNAVAILABLE",
  "message": "The lookup service is temporarily unavailable. Please retry later."
}