Retrieve the frequency of a word derived from a corpus.
This endpoint provides the frequency of a given word. When multiple database records match the query parameters, the returned frequency is the sum of the individual frequencies. For example, if the query parameters are lemma=test, the returned frequency will include the verb "test", the noun "test" and the adjective "test" in all forms (Test, tested, testing, etc.) <br> <br> If you are interested in the frequency of the word "test" but want to exclude other forms (e.g., tested) use the option trueCase=test. Normally, the word "test" will be spelt with a capital letter at the beginning of a sentence. The option trueCase will ignore this and it will count "Test" and "test" as the same token. If you are interested in frequencies of "Test" and "test", use the option wordform=test or wordform=Test. Note that trueCase is not just a lower case of the word as some words are genuinely spelt with a capital letter such as the word "press" in Oxford University Press. <br> <br> Parameters can be provided in PATH, GET or POST (form or json). The parameters in PATH are overriden by parameters in GET, POST and json (in that order). In PATH, individual options are separated by semicolon and values are separated by commas (where multiple values can be used). Examples:
-
PATH: /lemma=test;lexicalCategory=noun
-
GET: /?lemma=test&lexicalCategory=noun
-
POST (json):
{ "lemma": "test", "lexicalCategory": "noun" }
<br> One of the options wordform/trueCase/lemma/lexicalCategory has to be provided.
Path parameters
IANA language code
Query parameters
For corpora other than 'nmc' (New Monitor Corpus) please contact api@oxforddictionaries.com
The written form of the word to look up (preserving case e.g., Books vs books)
The written form of the word to look up with normalised case (Books --> books)
The lemma of the word to look up (e.g., Book, booked, books all have the lemma "book")
The lexical category of the word(s) to look up (e.g., noun or verb)
Headers
App ID Authentication Parameter
App Key Authentication Parameter
Response
Successful response.