[{"data":1,"prerenderedAt":385},["ShallowReactive",2],{"\u002Fprovenance\u002Fdocs\u002F":3},{"id":4,"title":5,"body":6,"description":372,"extension":373,"isRevision":374,"lastUpdated":375,"meta":376,"navigation":377,"path":378,"revision":379,"seo":380,"slug":381,"stem":382,"subtitle":383,"__hash__":384},"docs\u002Fdocs\u002Fprovenance\u002Findex.md","Getty Provenance Index",{"type":7,"value":8,"toc":357},"minimark",[9,16,32,37,58,100,105,123,130,135,138,142,175,178,207,214,218,221,228,235,249,263,270,274,277,292,299,310,313,316,319,323,330,334,337,341,349,352],[10,11,12],"p",{},[13,14,15],"em",{},"This API Documentation is a work in progress.",[10,17,18,19,26,27,31],{},"The data available from this API is made available under ",[20,21,25],"a",{"href":22,"rel":23},"https:\u002F\u002Fcreativecommons.org\u002Fpublicdomain\u002Fzero\u002F1.0\u002F",[24],"nofollow","CC0",". Check the ",[20,28,30],{"href":29},"#usage-guidelines","Usage Guidelines"," section of this document for more details.",[33,34,36],"h4",{"id":35},"quick-reference","Quick Reference",[10,38,39,40,45,46,51,52,57],{},"This API is based on the ",[20,41,44],{"href":42,"rel":43},"https:\u002F\u002Flinked.art",[24],"Linked.Art"," standard, and uses ",[20,47,50],{"href":48,"rel":49},"https:\u002F\u002Fwww.w3.org\u002FTR\u002Factivitystreams-core\u002F",[24],"ActivityStreams"," to track changes. We also provide a ",[20,53,56],{"href":54,"rel":55},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FSPARQL",[24],"SPARQL"," endpoint to allow for graph queries.",[59,60,61,74,83],"ul",{},[62,63,64,68,69],"li",{},[65,66,67],"strong",{},"REST endpoints",": ",[20,70,73],{"href":71,"rel":72},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Ffbc91494-294c-30a6-b6dc-885f3ea074ed",[24],"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002F\u003CENTITY_ID>",[62,75,76,68,79],{},[65,77,78],{},"ActivityStream",[20,80,81],{"href":81,"rel":82},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Factivity-stream",[24],[62,84,85,68,87,91,92,95,96],{},[65,86,56],{},[20,88,89],{"href":89,"rel":90},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Fsparql",[24]," ",[93,94],"br",{}," There is also a GUI for SPARQL queries available at ",[20,97,98],{"href":98,"rel":99},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Fsparql-ui",[24],[101,102,104],"h2",{"id":103},"getting-started","Getting Started",[10,106,107,108,112,113,117,118,122],{},"This API is currently designed to accommodate three tasks: ",[20,109,111],{"href":110},"#getting-records-and-images","getting records",", ",[20,114,116],{"href":115},"#tracking-changes","tracking changes"," in records, and ",[20,119,121],{"href":120},"#asking-questions","asking questions"," about the collection as a whole.",[10,124,125,126,129],{},"We currently ",[13,127,128],{},"don't"," provide a way to get a list of all of the objects or other entity types in the dataset. We know how useful this would be, and it's on our roadmap. We also don't provide a way to download all the data in the dataset; this is also on the roadmap. Stay tuned.",[131,132,134],"h3",{"id":133},"getting-records","Getting Records",[10,136,137],{},"The first task is to access information about the records Getty has published, which are separated into types or \"entities\" in our dataset.",[33,139,141],{"id":140},"records","Records",[10,143,144,145,149,150,154,155,158,159,161,162,165,166,169,170,165,172,174],{},"The remodeled ",[20,146,5],{"href":147,"rel":148},"https:\u002F\u002Fwww.getty.edu\u002Fdatabases-tools-and-technologies\u002Fprovenance\u002F",[24]," provides open access to millions of resources from dealer stock books and sales catalogs. A typical type of record one might search for in this vast database is a sales ",[151,152,153],"code",{},"Activity"," of an artwork or ",[151,156,157],{},"Object",". A sales ",[151,160,153],{}," then leads to other related entity types, like the ",[151,163,164],{},"Person"," or ",[151,167,168],{},"Group"," that purchased the artwork along with the ",[151,171,164],{},[151,173,168],{}," that produced the artwork. Each entity within our dataset has a URL where you can access the record as a JSON document, and the JSON contains links to other entities across the dataset.",[10,176,177],{},"For example:",[59,179,180,186,193,200],{},[62,181,182,183],{},"The sale of a portrait of James Christie is available at ",[20,184,71],{"href":71,"rel":185},[24],[62,187,188,189],{},"The portrait of James Christie ",[20,190,191],{"href":191,"rel":192},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002F09539ab1-416d-3870-810b-8a6b3b604368",[24],[62,194,195,196],{},"The buyer of the portrait at the time of sale (Colnaghi's) is available at ",[20,197,198],{"href":198,"rel":199},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Fe58f4290-9160-3b64-9006-ed136dbd8d2a",[24],[62,201,202,203],{},"The object record of the portrait refers to the artist of the work, Thomas Gainsborough: ",[20,204,205],{"href":205,"rel":206},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002F8cc4b65a-ae05-39d1-9726-675b7c7d0161",[24],[10,208,209,210,213],{},"You can learn more about the model we use on the ",[20,211,44],{"href":42,"rel":212},[24]," website.",[131,215,217],{"id":216},"tracking-changes","Tracking Changes",[10,219,220],{},"The second task is to be able to know when changes happen in records. What we've found is that many users cache our records and want the latest data — but they don't want to re-download the entire dataset looking for changes — particularly since our records don't change that often!",[10,222,223,224,227],{},"Instead of forcing users to do that, we use the ",[20,225,50],{"href":48,"rel":226},[24]," protocol to publish an API that lists every record that's been created, edited, or deleted in date order. This standard emerged from social media — think of it as a timeline. Each activity has information about what happened, who did it, when they did it, and what they did it to. It's like a post every time a record changes! For the Provenance Index, this feed is available at:",[10,229,230],{},[65,231,232],{},[20,233,81],{"href":81,"rel":234},[24],[10,236,237,238,242,243,248],{},"The API provides a list of pages of activities — you can access the first page at ",[20,239,240],{"href":240,"rel":241},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Factivity-stream\u002Fpage\u002F1",[24],", which are the very first changes made to the API. You could also access ",[20,244,247],{"href":245,"rel":246},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Factivity-stream\u002Fpage\u002F139855",[24],"page 139855",", recording some of the changes that happened in March 2021.",[10,250,251,252,257,258,262],{},"Each page lists activities — for example, ",[20,253,256],{"href":254,"rel":255},"https:\u002F\u002Fdata.getty.edu\u002Fprovenance\u002Factivity-stream\u002F0d127034-9f8f-4348-9a28-b90d822802b5",[24],"this activity"," records a change to our record for ",[20,259,261],{"href":71,"rel":260},[24],"the sale of the portrait of James Christie",", showing that it was updated on March 2nd, 2025.",[10,264,265,266,269],{},"You can use the ActivityStream to get a list of every record we have in our system, by starting at the first page and crawling forward, keeping track of everything that's been created and deleted. If you already have a copy of our data, though, you can start at the ",[13,267,268],{},"last"," page and crawl backwards, only pulling the records that have changed since the last time you scanned!",[131,271,273],{"id":272},"asking-questions","Asking Questions",[10,275,276],{},"You might not want to look up a single record, or even pay attention to the entire dataset. There are so many interesting questions that we can't provide API endpoints that cover all of them. Instead, we provide a tool that lets you ask the API yourself.",[10,278,279,280,285,286,291],{},"Under the hood, our API is actually a knowledge graph that uses Linked Data standards ",[20,281,284],{"href":282,"rel":283},"https:\u002F\u002Fjson-ld.org",[24],"JSON-LD"," and ",[20,287,290],{"href":288,"rel":289},"https:\u002F\u002Fwww.w3.org\u002FRDF\u002F",[24],"RDF",". If you just want to use the API, you don't need to know that at all — just think of them as REST APIs that provide slightly unusual JSON.",[10,293,294,295,298],{},"However, if you're interested in taking advantage of those technologies and the graph nature of the data, you can use the ",[20,296,56],{"href":54,"rel":297},[24]," query language to write custom queries against our public SPARQL endpoint for the Provenance Index.",[10,300,301,302,305,306,309],{},"It's available at ",[20,303,89],{"href":89,"rel":304},[24],", and we provide a web-based interface for it at ",[20,307,98],{"href":98,"rel":308},[24],".",[10,311,312],{},"SPARQL can be deep magic — it's incredibly powerful, but because of that power it takes an investment of time to understand how best to use it.",[101,314,30],{"id":315},"usage-guidelines",[10,317,318],{},"We are providing this data without restrictions for all to enjoy. We've got a few guidelines, but we've worked hard to make this dataset as open and explorable as possible.",[131,320,322],{"id":321},"licensing","Licensing",[10,324,325,326,329],{},"This dataset is available under ",[20,327,25],{"href":22,"rel":328},[24],": you can use this data however you like without asking for permission.",[131,331,333],{"id":332},"attribution","Attribution",[10,335,336],{},"We respectfully ask that you acknowledge Getty as a source wherever possible, especially with respect to research or publication, in order to preserve a link to the dataset. By providing acknowledgment or citation, you enable others to verify, replicate, and further explore your presentation and interpretation of our data.",[131,338,340],{"id":339},"questions","Questions?",[10,342,343,344,348],{},"Please ",[20,345,347],{"href":346},"mailto:provenanceindex@getty.edu","contact us"," if you have any questions.",[350,351],"hr",{},[10,353,354],{},[65,355,356],{},"Go explore the data!",{"title":358,"searchDepth":359,"depth":359,"links":360},"",2,[361,367],{"id":103,"depth":359,"text":104,"children":362},[363,365,366],{"id":133,"depth":364,"text":134},3,{"id":216,"depth":364,"text":217},{"id":272,"depth":364,"text":273},{"id":315,"depth":359,"text":30,"children":368},[369,370,371],{"id":321,"depth":364,"text":322},{"id":332,"depth":364,"text":333},{"id":339,"depth":364,"text":340},"The Getty Provenance Index® provides open access to millions of resources from dealer stock books, sales catalogs, and archival inventories, revealing information on the ownership and market histories of artworks","md",false,"2023-05-23",{},true,"\u002Fdocs\u002Fprovenance","\u002Fprovenance\u002Fdocs\u002Frevision\u002F",{"title":5,"description":372},"\u002Fprovenance\u002Fdocs\u002F","docs\u002Fprovenance\u002Findex","Millions of resources from the Getty Provenance Index","j7HMdeTRyTWOhoO7mEheE4S-oRxikw8-pbz97RxgBwQ",1784569517639]