Skip to content

Oxford API

by oxforddictionaries.com

API keyHTTPSDictionaries
Open documentation ↗

Overview

The Oxford Dictionaries API gives you access to our world-renowned dictionary data, including definitions, translations, synonyms, and audio pronunciations.

Oxford is a dictionaries API from oxforddictionaries.com. Requests are authenticated with an API key. It is served over HTTPS and does not allow direct browser requests (no CORS). Its OpenAPI description documents 26 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
No
Category
Dictionaries
Base URL
https://od-api-demo.oxforddictionaries.com:443/api/v1
Version
1.11.0
Endpoints
26
Spec updated
2021-06-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://od-api-demo.oxforddictionaries.com:443/api/v1/filters" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://od-api-demo.oxforddictionaries.com:443/api/v1/filters", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://od-api-demo.oxforddictionaries.com:443/api/v1/filters",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/domains/{source_domains_language}/{target_domains_language}Lists available domains in a bilingual dataset
GET/domains/{source_language}Lists available domains in a monolingual dataset
GET/entries/{source_language}/{word_id}/sentencesRetrieve corpus sentences for a given word
GET/entries/{source_lang}/{word_id}Retrieve dictionary information for a given word
GET/entries/{source_lang}/{word_id}/antonymsRetrieve words that mean the opposite
GET/entries/{source_lang}/{word_id}/regions={region}Specify GB or US dictionary for English entry search
GET/entries/{source_lang}/{word_id}/synonymsRetrieve words that are similar
GET/entries/{source_lang}/{word_id}/synonyms;antonymsRetrieve synonyms and antonyms for a given word
GET/entries/{source_lang}/{word_id}/{filters}Apply filters to response
GET/entries/{source_translation_language}/{word_id}/translations={target_translation_language}Retrieve translation for a given word
GET/filtersLists available filters
GET/filters/{endpoint}Lists available filters for specific endpoint
GET/grammaticalFeatures/{source_language}Lists available grammatical features in a dataset
GET/inflections/{source_lang}/{word_id}/{filters}Check a word exists in the dictionary and retrieve its root form
GET/languagesLists available dictionaries
GET/lexicalcategories/{language}Lists available lexical categories in a dataset
GET/regions/{source_language}Lists available regions in a monolingual dataset
GET/registers/{source_language}Lists available registers in a monolingual dataset
GET/registers/{source_register_language}/{target_register_language}Lists available registers in a bilingual dataset
GET/search/{source_lang}Retrieve possible matches to input
GET/search/{source_search_language}/translations={target_search_language}Retrieve possible translation matches to input
GET/stats/frequency/ngrams/{source_lang}/{corpus}/{ngram-size}/Retrieve the frequency of ngrams (1-4) derived from a corpus
GET/stats/frequency/word/{source_lang}/Retrieve the frequency of a word derived from a corpus.
GET/stats/frequency/words/{source_lang}/Retrieve a list of frequencies of a word/words derived from a corpus.
GET/wordlist/{source_lang}/{filters_advanced}Retrieve list of words for category with advanced options
GET/wordlist/{source_lang}/{filters_basic}Retrieve a list of words in a category

Questions

Does the Oxford API need an API key?

Yes. The Oxford API uses API key authentication; the documentation explains how to get credentials.

Can I call the Oxford API from the browser?

Not directly. The Oxford API does not send CORS headers, so call it from your server or a proxy instead of browser JavaScript.

Does the Oxford API support HTTPS?

Yes, the Oxford API is served over HTTPS.

How many endpoints does the Oxford API have?

Its OpenAPI description lists 26 endpoints in version 1.11.0. All of them are shown on this page.

What are alternatives to the Oxford API?

Other Dictionaries APIs include Wordnik, Collins, Synonyms, Free Dictionary, WordSoHard.

Compare alternatives →

Listed from public-apis (MIT), public-apis database (MIT), APIs.guru (CC0).