Historical Thesaurus API V1

This API is currently only used to generate data about the number of words for Thematic Headings, split into decades.

Data is available as JSON or CSV.

List of Endpoints

Period Statistics

Returns statistics relating to a given period.

Argument 1 contains the start decade (e.g. 10101019).

Argument 2 contains the end decade (e.g. 19901999). Note that the final decade is one year longer: 20002010

Examples

Statistics about the full period (i.e. 1010 to 2010)

Statistics about the period from 1470 to 1799

Thematic Heading data by Decade

Returns information about thematic headings matching the supplied criteria. Number of words in each decade (represented as a percentage of the largest number of words for the heading) are returned in addition to metadata about the Thematic Heading.

There are five types of search (described below). Several arguments are common to each as follows:

Argument 1 contains the search type and must either be all, peak, plateau, rise, fall.

Argument 2 contains the start decade of the period you are interested in (e.g. 10101019)

Argument 3 contains the end decade of the period you are interested in (e.g. 19901999)

Argument 4 contains the lowest average category size and can be an integer or a float (or null)

Argument 5 contains the highest average category size and can be an integer or a float (or null)

Argument 6 contains the minimum size of the largest category and can be an integer (or null)

Type 'peak'

Additional arguments:

Argument 7 contains the start decade of the period in which the peak is found (e.g. 12001209). This must be within the period specified in Arguments 1 and 2.

Argument 8 contains the end decade of the period in which the peak is found (e.g. 13901399). This must be within the period specified in Arguments 1 and 2.

Argument 9 contains the minimum percentage difference between the largest value and the end value. This can be an integer between 0 and -100 (or null), e.g. -50.

Argument 10 contains the minimum standard deviation and can be an integer or float (or null), e.g. 20.

Type 'plateau'

Additional arguments:

Argument 7 contains the minimum frequency of mode and can be an integer (or null).

Argument 8 contains the minimum mode and can be an integer (or null).

Argument 9 contains the minimum frequency of 5% either way from mode and can be an integer (or null).

Type 'rise'

Additional arguments:

Argument 7 contains the minimum size of the largest decade to decade rise and can be an integer (or null)

Argument 8 contains the minimum percentage rise of average category size and can be an integer (or null).

Type 'fall'

Additional arguments:

Argument 7 contains the minimum percentage fall of average category size and can be an integer (or null).

Note that if all arguments within a type are missing or null then the output will default to a search for 'all'

Examples

Display all Thematic Headings for the period from 1010 to 2010 thathave an average size between 50 and 300 and a minimum largest category size of 100

Display all Thematic Headings for the period from 1200 to 1799 that have a peak between 1300 and 1599, a minimum percentage difference between the largest value and end of -20 and a minimum standard deviation of 5

Display all Thematic Headings for the period from 1300 to 1999 that have an average category size of between 10 and 500 that have a plateau defined as a minimum frequency of mode of 20, a minimum mode of 10 and a minimum frequency of 5% either way from mode of 10

Display all Thematic Headings for the period from 1010 to 2010 that have a minimum size of largest category of 50 that have a trauma rise defined as a minimum size of largest decade to decade rise of 200 and a minimum percentage rise of average category size of 50

Display all Thematic Headings for the period from 1010 to 2010 that have an average category size of between 50 and 400 that have a trauma fall as defined as a minimum percentage fall of average category size of -50

List of Decades

Returns a list of the decades that the data is split into. Does not accept any arguments

Example