API endpoints overview
- 362 All Categories
- 2 Member guidelines
- 63 Ask the Community: Technical and operational questions
- 68 General
- 10 Ask the Community: Other
- 60 Report a bug
- 12 Suggest an improvement
- 7 How to get useful technical help
- 92 Frequently asked questions
- 6 Tutorials and presentations
- 26 API endpoints
- 9 News and updates
- 3 Language datasets
- 18 Review my code
Note: This announcement applies to API customers that are registered to a Prototype and Developer plans.
We are writing to inform you that a new set of plans is replacing our current application plans (Prototype and Developer plans) and prices.
As of 10th May 2022, the Prototype and Developer plans will no longer be operational. Oxford Dictionaries API will offer two new plans:
- Introductory plan
- Unlimited plan
For Prototype and Developer plan customers, changes are happening between 12th April 2022 and 10th May 2022. So do not worry! You will have time to check the options and choose how you wish to proceed using our data by selecting the Introductory or Unlimited plan.
For further instructions on how to change plans, and for more information, please visit our new plans announcement page.
If you have any questions, please feel free to leave us a comment or reach us at our Contact Us page. (https://developer.oxforddictionaries.com/contact-us)
The Oxford dictionaries API team
API endpoints overview
For more detailed information and try out visit our documentation page
Entries: Use this to retrieve definitions, pronunciations (audio files and phonetic spellings), example sentences, grammatical information and word origins.
- Entries only work for dictionary headwords
- You can use filter in this endpoints, and combine them.
Lemmas: to check if the word exists in the dictionary or what 'root' form it links to (e.g., swimming > swim).
- Can be combined with other endpoints
- Can also combine filters with the results
Search: to retrieve possible headword matches for a given string of text. The results are calculated using headword matching, fuzzy matching, and lemmatization
- Search translations: to find possible translations for a given word.
Translations: can be used when translating a word in one language to another. In the event that a word in the dataset does not have a direct translation, the response will be a definition in the target language.
Thesaurus: Use this to retrieve words that are similar or opposite in meaning to the input word (synonym/antonym).
Sentences: Use this to retrieve sentences extracted from a corpus of real-world language, including news and blog content. This is available for English and Spanish. For English, the sentences are linked to the correct sense of the word in the dictionary. In Spanish, they are linked at the headword level.
- Only for English and Spanish
Utility: To allow quick and easy exploration of our data. You can explore:
- The available categories within a particular dataset.
- Find out domains: returns a list of the available domain tags within a dataset (e.g., nautical, photography).
- Fields: Returns a list of the available fields to construct API requests.
- LexicalCategories: returns the lexical categories, or parts of speech, identified in a particular dataset (e.g., particle, noun, determiner).
- GrammaticalFeatures: Returns a list of the available grammatical features for a given dataset.
- Filters: lists the different attributes you can filter different endpoints by.
- Languages: lists the datasets available with a specified source or target language
- Registers: returns the register labels present in a specified dataset (e.g., informal, technical, or even ‘theatrical slang’).
Oxford Dictionaries data is incredibly rich in depth and detail, and the above Utility endpoints aim to make navigating it that bit easier.
Words: Use this endpoint to retrieve definitions, examples and other information for a given dictionary word or an inflection (e.g., running > run). The response contains information about the lemmas to which the given word/inflected form is linked.
- The results can be filtered by lexicalCategories, domains, registers or grammaticalFeatures. Filters can be combined.
- In addition, Users can use fields to project some of the properties.
Inflections: Retrieves the inflected forms of a given words.
Here you can see which language datasets are available