The following information and examples may guide those who wish to use the data releases of AAT, ULAN, or TGN. For users who wish to search for individual terms and names in AAT, ULAN, TGN, CONA, or IA, see the search interface linked from the Getty Vocabularies online. CONA and IA are not yet available as data files.

The Getty Vocabularies change and grow over time; thousands of records are edited or added each year. Implementers are encouraged to refresh the data regularly. The Getty Vocabulary data is made available by the J. Paul Getty Trust under the Open Data Commons Attribution License (ODC-By) 1.0. Note that the Getty Vocabulary data is compiled from various contributors using published sources; the contributor and sources should be cited along with the J. Paul Getty Trust when the data is displayed.

Linked Open Data
The AAT, TGN, and ULAN are available in JSON, RDF, N3/Turtle, and N-Triples. The data is refreshed monthly. See the SPARQL endpoint at Getty Vocabularies: LOD. See documentation in a printable version (PDF, 92pp., 3.84MB) or online. Included are sample queries that users may consult in order to acquire the data according to various criteria. See also general information on the Getty Vocabularies as Linked Open Data.

Web services
The AAT, TGN, and ULAN data files may be accessed through Web services APIs (application programming interfaces), which provide access to data that is refreshed monthly. Note that the data is subject to frequent additions and updates. See details in the Web Services User's Instructions (PDF, 4pp., 17KB).

Relational Tables and XML
The AAT, TGN, and ULAN are available in XML and relational tables formats. This data is released monthly. Sample records are linked below. To access full data sets in XML and relational tables formats, see AAT downloads, TGN downloads, and ULAN downloads.

No software is provided. Only full sets of data are available; we do not provide subsets of the data (other than the sample sets below).

Data dictionaries: Note that data dictionaries for XML and relational tables formats below do not give step-by-step instructions on how to construct a database or interface based on the data files; analysis and a programmer will be required to implement the vocabulary data files. The Getty does not provide technical support. For details regarding data content and editorial rules, see the Editorial Guidelines.


AAT: Data dictionaries and sample records. The AAT is a hierarchical vocabulary; the full data set contains around 45,781 records (subject_id, as of 20 April 2019) for generic concepts (not having proper names). Included are terms, descriptions, bibliographic citations, and other information relating to fine art, architecture, decorative arts, archival materials, archaeology, conservation, and other material culture. The sample available here is a small subset of the AAT. For further information, see About the AAT.

AAT Sample Data
Format options:

 

Schema and data dictionary for
AAT Data Releases

XML UTF-8 (5MB)

 

XML Schema

Relational Table UTF-8 (72MB)

 

Relational Table format DD (PDF, 10pp., .30MB)



ULAN: Data dictionaries and sample records. The ULAN is a structured vocabulary; the full data set contains around 301,323 records (subject_id, as of 29 April 2019), including names and biographical and bibliographic information for artists, architects, sitters, patrons firms, studios, art repositories, including a wealth of variant names, pseudonyms, and language variants. The sample available here is a small subset of the ULAN. For further information, see About the ULAN.

ULAN Sample Data
Format options:

 

Schema and data dictionary for
ULAN Data Release

XML UTF-8 (28MB)

 

XML Schema

Relational Table UTF-8 (124MB)

 

Relational Table format DD (PDF, 14pp., .36MB)



TGN: Data dictionaries and sample records. The full TGN is a hierarchical vocabulary; the full data set contains around 2,505,140 records (subject_id, as of 29 April 2019), including names, place types, coordinates, and descriptive notes, focusing on current and historical places and sites important for the study of art, architecture, conservation, and related disciplines. TGN is not a GIS; coordinates are included for many records, but they are for finding purposes only (i.e., to find the place on a map). The sample available here is a small subset of the TGN. For further information, see About the TGN.

TGN Sample Data
Format options:

 

Schema and data dictionary for
TGN Data Release

XML UTF-8 (7MB)

 

XML Schema

Relational Table UTF-8 (28MB)

 

Relational Table format DD (PDF, 13pp., .38MB)



The Art & Architecture Thesaurus® (AAT), the Union List of Artists Names® (ULAN), the Getty Thesaurus of Geographic Names® (TGN), the Cultural Objects Name Authority® (CONA), and the Getty Iconography Authority (IA)™ are made available by the J. Paul Getty Trust under the Open Data Commons Attribution License (ODC-By) 1.0. Note that the Getty Vocabulary data is compiled from various contributors using published sources; the contributor and sources should be cited along with the J. Paul Getty Trust when the data is displayed. For questions, send an email to vocab@getty.edu.

No warranties by Getty: The databases are provided "as is." Getty disclaims all other warranties, either express or implied, including, but not limited to, implied warranties of merchantability and fitness for a particular purpose, with respect to the databases.



Revised 1 May 2019