SCOSYA API V1

Data are available as JSON or CSV.

The linguistic data featured in this resource are copyright of the University of Glasgow. Tables of data are available to download as CSV files, or as JSON data. All linguistic data taken from this resource should be properly attributed:

Smith, Jennifer; Adger, David; Aitken, Brian; Heycock, Caroline; Jamieson, E and Thoms, Gary. 2019. The Scots Syntax Atlas. University of Glasgow. https://scotssyntaxatlas.ac.uk

Data are made available through a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. This allows users to share and adapt the materials freely with the appropriate attribution but not for commercial purposes. Please see further details of this license here: http://creativecommons.org/licenses/by-nc-sa/4.0/
Creative Commons License

List of Endpoints

Locations

Returns all of the questionnaire locations:

Attributes

Returns all of the attributes, including their IDs, which are used to return rating data:

Argument 1 set to 'public' limits attributes to only those marked for inclusion in the public atlas. Leave blank otherwise

Public Attrbibutes only:

Attribute

Returns rating data for one or more passed attribute IDs separated by a comma. Locations that contain no matching data are also returned. These have no 'qid' field and appear after the main data.

Argument 1 contains attribute IDs, separated by a comma.

Argument 2 contains the Boolean join types for each attribute (either 'and', 'or' or 'not', default is 'and') separated by a comma.

Argument 3 contains the age limits ('all', 'young', 'old', default is 'all') for each attribute, separated by a comma.

Argument 4 contains the minimum number of people that must have supplied a rating at each location for it to be included, for each attribute, separated by a comma. Thr default value is '1' or more people. For an age limit of 'All' the value can be between 1 and 4. For an age limit of 'young' or 'old' the value must be '1' or '2'.

Argument 5 contains the rating levels that should be returned for each attribute, separated by a comma. Rating levels are 1-5 and multiple levels can be passed as a concatenated string, e.g. '45' returns rating levels '4' and '5'. The default is '12345' (all levels).

Argument 6 contains the 'interviewer' type ('fieldworker','participant','both') for each attribute, separated by a comma.

Argument 7 allows you to include spurious data. This isn't used in the atlas. To include spurious data add the string 'includeSpurious'.

Argument 8 allows you to specify whether geoJSON areas or only a point is returned. The default is geoJSON included. Specify 'point' to remove geoJSON (makes download sizes considerably smaller).

Argument 9 allows you to specify one or more locations, separated by a comma.

Examples

Retrieve all data for attribute ID 18, including spurious data:

Retrieve the data for attribute 126 for the 'young' age group where 1 or more people have rated it at levels 4 or 5 and interviews were conducted by a fieldworker, OR attribute 135 for the 'old' age group where 2 or more people have rated it at levels 1 or 2 and interviews were conducted by a participant, not including spurious data:

Code

Returns rating data for one or more passed code IDs separated by a comma. Locations that contain no matching data are also returned. These have no 'qid' field and appear after the main data.

Argument 1 contains code IDs, separated by a comma.

Argument 2 contains the Boolean join types for each attribute (either 'and', 'or' or 'not', default is 'and') separated by a comma.

Argument 3 contains the age limits ('all', 'young', 'old', default is 'all') for each attribute, separated by a comma.

Argument 4 contains the minimum number of people that must have supplied a rating at each location for it to be included, for each attribute, separated by a comma. Thr default value is '1' or more people. For an age limit of 'All' the value can be between 1 and 4. For an age limit of 'young' or 'old' the value must be '1' or '2'.

Argument 5 contains the rating levels that should be returned for each attribute, separated by a comma. Rating levels are 1-5 and multiple levels can be passed as a concatenated string, e.g. '45' returns rating levels '4' and '5'. The default is '12345' (all levels).

Argument 6 contains the 'interviewer' type ('fieldworker','participant','both') for each attribute, separated by a comma.

Argument 7 allows you to include spurious data. This isn't used in the atlas. To include spurious data add the string 'includeSpurious'.

Argument 8 allows you to specify whether geoJSON areas or only a point is returned. The default is geoJSON included. Specify 'point' to remove geoJSON (makes download sizes considerably smaller).

Argument 9 allows you to specify one or more locations, separated by a comma.

Examples

Retrieve all data for attribute ID 18, including spurious data:

Retrieve the data for attribute 126 for the 'young' age group where 1 or more people have rated it at levels 4 or 5 and interviews were conducted by a fieldworker, OR attribute 135 for the 'old' age group where 2 or more people have rated it at levels 1 or 2 and interviews were conducted by a participant, not including spurious data:

Stories

Returns a list of IDs, titles and descriptions for all available Stories for display in the public atlas:

Story

Returns the full data for a single story identified by ID:

Argument 1 contains the story ID

Location Groups

Returns a list of publicly available location groups:

Location Group

Returns all of the locations within a location group with the passed ID (ID must correspond to a publicly available group):

Argument 1 contains the group ID

Community Voices Locations

Returns a list of locations that have Community Voices data:

Community Voice

Returns all of the Community Voice data for the location with the passed ID (ID must correspond to a publicly available location that features Community Voice data):

Argument 1 contains the Location ID

Home Clip Locations

Returns a list of locations that appear on the 'Home' map in the public atlas: