Dictionary API
The Dictionary API allows you to look up definitions for any English word.
From 9,274 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 375ms | 397ms | 420ms | 787ms | 1240ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
/v1/dictionary GET
https://api.api-ninjas.com/v1/dictionary
Returns a string containing definitions for a given word.
Parameters
wordrequiredWord to look up.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON object with the following fields or an error if the request is unsuccessful.
wordThe word that was looked up.
definitionThe definition of the word (only present if
validistrue).validWhether the word is valid (
trueorfalse).
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/dictionary?word=codeHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/dictionary?word=example" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the Dictionary API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Dictionary API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Dictionary API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Dictionary API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I look up a word with the Dictionary API?
Send a GET request to the/v1/dictionaryendpoint with the requiredwordparameter set to the term you want to define, for exampleword=code. You will need an API key in theX-Api-Keyheader, which you can get by registering for an account.What fields does the Dictionary API response include?
The response is a JSON object containingword(the word that was looked up),definition(the definition text, only present when the word exists), andvalid(a boolean indicating whether the word was found). Ifvalidisfalse, nodefinitionfield is returned. See the error codes page for unsuccessful requests.What are some use cases for the Dictionary API?
The Dictionary API is useful for building vocabulary tools, language-learning apps, writing assistants, and word games that need definitions for any English word. It pairs well with related Text APIs such as the Thesaurus API for synonyms, the Spell Check API for corrections, and the Random Word API for generating prompts.How can I tell if a word is not a real word?
Check thevalidfield in the response: it returnstruewhen the word exists in the dictionary andfalsewhen it does not, in which case nodefinitionis included. To suggest a correct spelling for an invalid word, combine it with the Spell Check API.