Corpus Search

Utility for web interface only. A list of values for a given structure attribute (avattr).

Not to be used outside the web interface. Replaced by a more powerful wordlist.

get/search/attr_vals

Request

  • The document declares no server URL.
  • Auth: HTTP basic

Query parameters

corpnamestring required

Corpus name. To query your own corpus (e.g. username john, corpus mycorpus), use value user/john/mycorpus.

avattrstring required

Selects a structure attribute (reffered to as text type in the web interface). Corpora have different numbers structure attributes and their values. You can find them in the response of the corpus_info method in freqttattrs or subcorpattrs keys. Not all of them have attributes to show.

avpatstring

A regex to filter the results. Empty string defaults to .* (match everything).

avfrominteger

The starting index from which to return the results.

avmaxitemsinteger

The number of items to return.

icase1 | 0

Switches to the lc attribute, i.e. the lower-cased version of the corpus to allow case insensitive searching. 1 means that case sensitivity is off, 0 means it is on.

format'json' | 'xml' | 'csv' | 'tsv' | 'txt' | 'xls'

The format of the output. Empty value is interpreted as JSON. Not every endpoint supports all formats.

Response

OK

querystring

The regular expression from query parameter avpat.

suggestionsstring[]

Suggestions for avattr bncdoc.author.

no_more_valuesboolean

Represent if the suggestion list is complete.

api_versionstring
manatee_versionstring

Example response

{
  "query": ".*",
  "suggestions": [
    "[ \"Cookson, Neil Andrew\", … ]"
  ],
  "api_version": "5.63.1",
  "manatee_version": "2.36.7-SkE-2.221",
  "request": {
    "avpat": ".*",
    "avmaxitems": "15",
    "ajax": "1",
    "corpname": "preloaded/bnc2_tt21",
    "avfrom": "0",
    "icase": "1",
    "avattr": "bncdoc.author"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.