Dictionary

Dictionary Suggestions

0calls

1 credits / call

Want typeahead in your dictionary search box? Users type a few letters and instantly see matching candidates — that is what this endpoint is for.

Overview

Pass the prefix the user is typing via q (also accepts word). You get a list of candidate words with short meanings. After the user picks one, call the Word Lookup endpoint for the full entry.

What's Returned

query: the prefix that was actually matched.
count: how many suggestions came back.
suggestions: the list. Each item has word and optional meaning.

Notes

Empty results If nothing matches, the response is still HTTP 200 and suggestions is []. Clear the candidate list on the frontend — do not treat it as an error.

Query parameters

q

stringrequired

English prefix to complete, up to 64 characters. The name word also works.

limit

integeroptional

Max number of suggestions. Default 10, maximum 30.

Name	Type	Attributes	Description
`q`	string	required	English prefix to complete, up to 64 characters. The name `word` also works.
`limit`	integer	optional	Max number of suggestions. Default 10, maximum 30.

Response

200 / OK

Success. When nothing matches, suggestions is an empty array.

JSON

400 / Bad Request

Invalid parameters, e.g. empty q, too long, or a bad limit.

502 / Bad Gateway

Service temporarily unavailable. Please try again later.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/dictionary/suggest?q=pre'

Frequently asked questions

Are there any special restrictions for the Dictionary Suggestions API?

Dictionary Suggestions follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

PreviousWord Lookup

NextWord Pronunciation