The following information and examples may guide those who wish to license the AAT, ULAN, or TGN. The Getty vocabularies change and grow over time; thousands of records are edited or added each year. Implementors 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.

Linked Open Data: The AAT, TGN, and ULAN are available fee-free in JSON, RDF, N3/Turtle, and N-Triples under the Open Data Commons Attribution License (ODC-By) 1.0. 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 data files may be accessed through Web services APIs (application programming interfaces), which provide access to data that is refreshed every two weeks. Note that the data is subject to frequent additions and updates. The APIs are available to any institution having a login, which may be obtained by writing to vocab@getty.edu. See details in the Web Services User's Instructions (PDF, 153pp., 2MB).

Relational Tables and XML: Sample records in Relational Tables and XML formats are linked below. To access full data sets in XML and Relational Tables formats, your institution must obtain a login by writing to vocab@getty.edu.

The data is compiled from various contributors using published sources, which must be cited along with the J. Paul Getty Trust when the data is displayed.

The AAT, ULAN, and TGN XML and relational tables formats were last released in June 2016. No software is provided. Only full sets of data are available for licensing; we do not provide subsets of the data (other than the sample sets below).

We encourage users to transition to the LOD release formats, since it is likely that relational tables and XML releases will be discontinued in the future.

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 competent 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.

Data currently available: The full data sets currently available were cut in Spring 2016.


Download sample records from the Art & Architecture Thesaurus (AAT). The full AAT is a hierarchical vocabulary of around 42,927 records, including 334,248 terms, descriptions, bibliographic citations, and other information relating to fine art, architecture, decorative arts, archival materials, archaeology, and other material culture. The full XML data file for the AAT is around 65 MB in size. The sample available here is a small subset of the AAT. For further information, see About the AAT.

AAT Sample Data
Format options:

 

Data Dictionary for the
AAT Data Release

XML UTF-8 (5MB)

 

XML format (PDF, 22pp., 419MB)

Relational Table UTF-8 (65MB)

 

Relational Table format (PDF, 11pp., 264MB)



Download sample records from the Union List of Artist Names (ULAN). The full ULAN is a vocabulary of around 241,740 records, including 636,709 names and biographical and bibliographic information for artists, architects, firms, shops, and art repositories, including a wealth of variant names, pseudonyms, and language variants. The full XML data file for the ULAN is around 145 MB in size. The sample available here is a small subset of the ULAN. For further information, see About the ULAN.

ULAN Sample Data
Format options:

 

Data Dictionary for the
ULAN Data Release

XML UTF-8 (26MB)

 

XML format (PDF, 29pp., 545KB)

Relational Table UTF-8 (110MB)

 

Relational Table format (PDF, 14pp., 312KB)



Download sample records from the Getty Thesaurus of Geographic Names (TGN). The full TGN is a hierarchical vocabulary of around 2,493,638 records, including 4,032,362 names, place types, coordinates, and descriptive notes, focusing on places important for the study of art and architecture. 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 full XML data file for the TGN is around 356 MB in size. The sample available here is a small subset of the TGN. For further information, see About the TGN.

TGN Sample Data
Format options:

 

Data Dictionary for the
TGN Data Release

XML UTF-8 (8MB)

 

XML format (PDF, 28pp., 537KB)

Relational Table UTF-8 (27MB)

 

Relational Table format (PDF, 14pp., 343KB)



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. 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 September 2016