Skip to content

Connecting to Getty

Jump to bottom
E. Lynette Rayle edited this page Feb 26, 2019 · 1 revision

Overview

The Getty vocabularies contain structured terminology for art and other material culture, archival materials, visual surrogates, and bibliographic materials.

More Information

Prerequisites

No additional setup required.

Accessing via QA

Authority: getty

Subauthorities:

  • aat
  • tgn
  • ulan

NOTE: The linked data module for QA also provides access to this authority. It returns additional data including the URI for terms. See Using-the-Linked-Data-module-to-access-authorities for more information.

Example search queries

Example search subauthority aat:

/qa/search/getty/aat?q=amphora

Result:

[
  {"id":"http://vocab.getty.edu/aat/300198849","label":"Nolan amphorae"},
  {"id":"http://vocab.getty.edu/aat/300200366","label":"Panathenaic amphorae"},
  etc.
]

NOTE: The qa request is converted to the following Getty request. This is for information only. You do not need to know this to use QA.

http://vocab.getty.edu/sparql.json?query=#{URI.escape(sparql(q))}&_implicit=false&implicit=true&_equivalent=false&_form=%2Fsparql

See att.rb#sparql(q) for details on what gets substituted for URI.escape(sparql(q)) in the URL.

Example search subauthority tgn:

/qa/search/getty/tgn?q=memphis

Result:

[
  {"id":"http://vocab.getty.edu/ulan/500125093","label":"Memphis (Corporate Bodies)"},
  {"id":"http://vocab.getty.edu/ulan/500302737","label":"Memphis Brooks Museum of Art (Corporate Bodies)"},
  etc.
]

NOTE: The qa request is converted to the following Getty request. This is for information only. You do not need to know this to use QA.

http://vocab.getty.edu/sparql.json?query=#{query.gsub('&', '%26').gsub(',[%5E,]+,[%5E,]+$', '%2C[^%2C]%2B%2C[^%2C]%2B%24')}&_implicit=false&implicit=true&_equivalent=false&_form=%2Fsparql

See tgn.rb#sparql(q) for details on what gets substituted for query in the URL.

Example search subauthority ulan:

/qa/search/getty/ulan?q=washington

Result:

[
  {"id":"http://vocab.getty.edu/ulan/500016005","label":"Allston, Washington (American painter, 1779-1843)"},
  {"id":"http://vocab.getty.edu/ulan/500208627","label":"American Institute of Architects, Washington Chapter (American architectural firm, contemporary)"},
  etc.
]

NOTE: The qa request is converted to the following Getty request. This is for information only. You do not need to know this to use QA.

http://vocab.getty.edu/sparql.json?query=#{URI.escape(sparql(q)).gsub('&', '%26')}&_implicit=false&implicit=true&_equivalent=false&_form=%2Fsparql

See ulan.rb#sparql(q) for details on what gets substituted for URI.escape(sparql(q)) in the URL.

Example term fetch request

Example fetch from subauthority aat:

/qa/show/getty/aat/300053264

Result:

{"head":{"vars":["Subject","Predicate","Object"]},
 "results":{"bindings":[
   {"Subject":{"type":"uri","value":"http://vocab.getty.edu/aat/300053264"},
    "Predicate":{"type":"uri","value":"http://www.w3.org/1999/02/22-rdf-syntax-ns#type"},
    "Object":{"type":"uri","value":"http://vocab.getty.edu/ontology#Subject"}},
   {"Subject":{"type":"uri","value":"http://vocab.getty.edu/aat/300053264"},
    "Predicate":{"type":"uri","value":"http://www.w3.org/1999/02/22-rdf-syntax-ns#type"},
    "Object":{"type":"uri","value":"http://www.w3.org/2004/02/skos/core#Concept"}},
   etc.
}

NOTE: The qa request is converted to the following Getty request. This is for information only. You do not need to know this to use QA.

http://vocab.getty.edu/download/json?uri=http://vocab.getty.edu/aat/300053264.json"

Example fetch from subauthority tgn:

/qa/show/getty/tgn/1028772

Result:

{"head":{"vars":["Subject","Predicate","Object"]},
 "results":{"bindings":[
   {"Subject":{"type":"uri","value":"http://vocab.getty.edu/tgn/1028772"},
    "Predicate":{"type":"uri","value":"http://www.w3.org/1999/02/22-rdf-syntax-ns#type"},
    "Object":{"type":"uri","value":"http://vocab.getty.edu/ontology#Subject"}},
   {"Subject":{"type":"uri","value":"http://vocab.getty.edu/tgn/1028772"},
    "Predicate":{"type":"uri","value":"http://www.w3.org/1999/02/22-rdf-syntax-ns#type"},
    "Object":{"type":"uri","value":"http://www.w3.org/2004/02/skos/core#Concept"}},
   etc.
}

NOTE: The qa request is converted to the following Getty request. This is for information only. You do not need to know this to use QA.

http://vocab.getty.edu/download/json?uri=http://vocab.getty.edu/tgn/1028772.json"

Example fetch from subauthority ulan:

/qa/show/getty/ulan/500026846

Result:

{"head":{"vars":["Subject","Predicate","Object"]},
 "results":{"bindings":[
   {"Subject":{"type":"uri","value":"http://vocab.getty.edu/ulan/500026846"},
    "Predicate":{"type":"uri","value":"http://www.w3.org/1999/02/22-rdf-syntax-ns#type"},
    "Object":{"type":"uri","value":"http://vocab.getty.edu/ontology#Subject"}},
   {"Subject":{"type":"uri","value":"http://vocab.getty.edu/ulan/500026846"},
    "Predicate":{"type":"uri","value":"http://www.w3.org/1999/02/22-rdf-syntax-ns#type"},
    "Object":{"type":"uri","value":"http://www.w3.org/2004/02/skos/core#Concept"}},
   etc.
}

NOTE: The qa request is converted to the following Getty request. This is for information only. You do not need to know this to use QA.

http://vocab.getty.edu/download/json?uri=http://vocab.getty.edu/ulan/300264917.json"

Example list all terms

Not supported

Documentation

Home

Using Questioning Authority

Custom Controlled Vocabularies

Linked Data Access to Authorities

Contributing to Questioning Authority

Clone this wiki locally