TERM

Thesaurus provides a standard terminology for naming objects. It does not claim to provide the correct name for an object. It merely provides a name for use in museum cataloguing systems to enable accurate retrieval of information about objects.

The hierarchical structure of the thesaurus assists in searching. By organising object names, the relationships between objects can be made explicit. Object names are organised according to their hierarchical, associative or equivalence relationships. The object name thesaurus allows for more than one broader term for each object name. Any term is permitted to have multiple broader terms, for example ‘Bubble pipes’ has the broader terms of ‘Pipes’ and ‘Toys’. There is no single hierarchy in which an object name is located, enabling it to by found by searchers approaching with different concepts in mind.

All terms within the thesaurus are plural. This standard was determined when the thesaurus was first published. The thesaurus attempts to place object names within an Australian context; we therefore commonly use the Macquarie Dictionary as a general guideline when deciding on the preferred or non-preferred spelling for a term.

Terms relations:

Broader term: an object name at the next higher hierarchical level to the term in question. A broader term names a category of objects which are specifically named by narrower terms.

Narrower term: an object name at the next lower hierarchical level to the term in question. Narrower terms name objects which are types of objects named by a broader term.

Related term: an object name that is not in the hierarchy of the term in question, but is related in some way, such as by object use.

For more information go to the Powerhouse Museum Object Name Thesaurus.

GET

/api/v1/term/{term_id}/

Fields

"end": number of last item returned

"start": number of first item returned

"result": count of items returned

"total": total results from query

"terms": list of terms returned

a term contains:

"relations": Related Terms. The relation could be Broader, Narrower, Related.

"narrower_items_uri": uri to this terms related narrower items

"items_uri": uri to this terms related items

"num_items": number of Items related to the term.

"num_narrower_items" : number of Narrower Items related to the term.

"scope_notes" : a note that defines the use of the term in the thesaurus. This is not a dictionary definition of the term, but a statement of how it is used in this thesaurus.

"name": name of Collection

"id": Term's unique identifier

Example

List terms:
/api/v1/term/json/?api_key={your_key}&term=cars

Specific term:
/api/v1/term/4/json/?api_key={your_key}

 
 

Parameters

inherit

&start={x} start at item number x (integer, optional, default=0)

&limit={x} reurn x items in list (integer, optional, maximum=100, default=50)

 
 

Filters

inherit

'begins' Matches for when the term is at the start of the field only.

'ends' Matches for when the term is at the and of the field only.

'lt' Does a less than comparison.

'lte' Does a less than or equal to comparison.

'gt' Does a greater than comparison.

'gte' Does a greater than or equal to comparison.

'in' Term may have multiple comma separated values any of which is matched for in field via a 'contains' search.

'exact' Field must match term exactly (case sensitive).

'isblank' If term is 1 this filter matches when the field is empty, null or zero.

Use &{field}_isblank=0 to only return results where the field has some content.

So to find all collections where the name of the collection begins with 'tyrrell' use:

/api/{version}/collection/{response_format}/?api_key={your_key}&name_begins=tyrrell