Retrieve the frequency of a word derived from a corpus.

v1.0.0

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.)

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.

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):

One of the options wordform/trueCase/lemma/lexicalCategory has to be provided.

Input

{
  "type": "object",
  "properties": {
    "app_id": {
      "type": "string"
    },
    "app_key": {
      "type": "string"
    },
    "corpus": {
      "type": "string"
    },
    "lemma": {
      "type": "string"
    },
    "lexicalCategory": {
      "type": "string"
    },
    "source_lang": {
      "type": "string"
    },
    "trueCase": {
      "type": "string"
    },
    "wordform": {
      "type": "string"
    }
  },
  "required": [
    "app_id",
    "app_key",
    "source_lang"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Schema for lexi-stats results for a word/trueCase/lemma/lexicalCategory returned as a frequency",
  "properties": {
    "metadata": {
      "type": "object",
      "description": "Additional Information provided by OUP"
    },
    "result": {
      "type": "object",
      "description": "Frequency information for a given entity",
      "required": [
        "frequency",
        "matchCount",
        "normalizedFrequency"
      ],
      "properties": {
        "frequency": {
          "type": "integer",
          "description": "The number of times a word appears in the entire corpus"
        },
        "lemma": {
          "type": "string",
          "description": "A lemma of the word (e.g., wordforms \"lay\", \"laid\" and \"laying\" have all lemma \"lay\")"
        },
        "lexicalCategory": {
          "type": "string",
          "description": "A lexical category such as 'verb' or 'noun'"
        },
        "matchCount": {
          "type": "integer",
          "description": "The number of database records that matched the query params (stated frequency is the sum of the individual frequencies)"
        },
        "normalizedFrequency": {
          "type": "integer",
          "description": "The number of times a word appears on average in 1 million words"
        },
        "trueCase": {
          "type": "string",
          "description": "A given written realisation of a an entry (e.g., \"lay\") usually lower case"
        },
        "wordform": {
          "type": "string",
          "description": "A given written realisation of a an entry (e.g., \"Lay\") preserving case"
        }
      }
    }
  }
}