# Introduction
The Art Institute of Chicago's API provides JSON-formatted data as a REST-style service that allows developers to explore and integrate the museum’s public data into their projects. This API is the same tool that powers our website, our mobile app, and many other technologies in the museum.
If the application you're building will be public, please send it our way! We'd love to share it alongside some of the other projects that use our API. And if you have any questions, please feel free to reach out to us: engineering@artic.edu.
# Quick Start
An API is a structured way that one software application can talk to another. APIs power much of the software we use today, from the apps on our phones and watches to technology we see in sports and TV shows. We have built an API to let people like you easily get our data in an ongoing way.
TIP
Do you want all of our data? Are you running into problems with throttling or deep pagination? Consider using our data dumps instead of our API.
For example, you can access the /artworks
listing endpoint in our API by visiting the following URL to see all the published artworks in our collection:
https://api.artic.edu/api/v1/artworks
If you want to see data for just one artwork, you can use the /artworks/{id}
detail endpoint. For example, here's Starry Night and the Astronauts by Alma Thomas:
https://api.artic.edu/api/v1/artworks/129884
When you view these URLs in your browser, you might see a jumbled bunch of text. That's OK! If you're using Chrome, install the JSON Formatter extension, hit reload, and the results will be formatted in a way humans can read, too.
There is a lot of data you'll get for each artwork. If you want to only retrieve a certain set of fields, change the fields
parameter in the query to list which ones you want, like this:
https://api.artic.edu/api/v1/artworks?fields=id,title,artist_display,date_display,main_reference_number
TIP
The fields
parameter expects either an array of field names, or a comma-separated list of field names in a single string (e.g. example above). We encourage you to use it because it makes your queries run faster and lets us track which fields need continued support.
You can paginate through results using page
and limit
params:
https://api.artic.edu/api/v1/artworks?page=2&limit=100
If you want to search and filter the results, you can do so via our search endpoints. For example, here is a full-text search for all artworks whose metadata contains some mention of cats:
https://api.artic.edu/api/v1/artworks/search?q=cats
Here is the same search, but filtered to only show artworks that are in the public domain:
https://api.artic.edu/api/v1/artworks/search?q=cats&query[term][is_public_domain]=true
Behind the scenes, our search is powered by Elasticsearch. You can use its Query DSL to interact with our API. The example above uses a term
query. Other queries we use often include exists
and bool
. Aggregations are also a powerful tool.
Our API accepts queries through both GET
and POST
. It might be easier to visualize how the GET
query above is structured by comparing it to its POST
equivallent:
curl --location --request POST 'https://api.artic.edu/api/v1/artworks/search' \
--header 'Content-Type: application/json' \
--data-raw '{
"q": "cats",
"query": {
"term": {
"is_public_domain": true
}
}
}'
For production use, we recommend using GET
and passing the entire query as minified URL-encoded JSON via the params
parameter. For example:
https://api.artic.edu/api/v1/artworks/search?params=%7B%22q%22%3A%22cats%22%2C%22query%22%3A%7B%22term%22%3A%7B%22is_public_domain%22%3Atrue%7D%7D%7D
WARNING
Our API is flexible in how it accepts queries, but each method of querying is meant for a specific purpose. See GET vs. POST for more details.
There's a lot of information you can get about our collection, and there's a lot more than artworks in our API. Explore our documentation to learn more!
# Conventions
We refer to models in our API as "resources" (e.g.
artworks
,artists
,places
)Resources are typically accessed via their endpoints. Each resource has three endpoints:
- Listing (e.g.
/artworks
) - Detail (e.g.
/artworks/{id}
) - Search (e.g.
/artworks/search
) (optional)
Some resources might lack a search endpoint if there appears to be no need for it yet.
- Listing (e.g.
Multi-word endpoints are hyphenated (e.g.
/tour-stop
).All field names are lowercase and snake case (underscore case).
Every resource in the API has
id
andtitle
fields.Fields that contain a single id reference to another resource are singular and end with
_id
:"artist_id": 51349,
Fields that contain id references to multiple records from another resource are singular and end with
_ids
:"style_ids": ["TM-4439", "TM-8542", "TM-4441"],
Fields that contain title references to records from other resources follow naming conventions similar to id-based fields:
"artist_title": "Ancient Roman", "classification_titles": ["modern and contemporary art", "painting"],
Every title-based field has a
keyword
subfield in Elasticsearch, which is meant for filters and aggregations. See "New defaults" section in this article for more info.Numeric and boolean fields get parsed into actual numbers and booleans:
"artwork_id": "45", // BAD "date_start": 1942, // GOOD "is_preferred": "True", // BAD "is_in_gallery": true, // GOOD
We never show any empty strings in the API. We only show
null
:"date_display": "", // BAD "artist_display": null, // GOOD
We prefer to always show all fields, even if they are
null
for the current record:If a field that typically returns a string, number, or object is empty for a given record, we return it as
null
, rather than omitting it.If a field typically returns an array, we prefer to return an empty array, rather than returning
null
. This is done in part for backwards-compatibility reasons.
# Best Practices
Here are some tips that will make your application run faster and/or reduce load on our systems:
Cache API responses in your system when possible.
Use the
fields
parameter to tell us exactly what fields you need.Batch detail queries with the multi-id parameter (
?ids=
).Batch search queries with multi-search (
/msearch
).When downloading images, use
/full/843,/0/default.jpg
parameters.When scraping, please use a single thread and self-throttle.
Consider using data dumps instead of scraping our API.
# Data Dumps
You can download a dump that contains all of our public data here:
https://github.com/art-institute-of-chicago/api-data
These data dumps are updated nightly. They are generated from our API. As such, they contain the same data as our API, and their schema mirrors that of the API. The data is dumped in JSON format, with one JSON file per record. Records are grouped by API resource type.
Our intention with this approach is to make it easier to adapt code to draw from the data dumps instead of the API, and vice-versa. Since the schema is the same, switching between the two should be relatively straight-forward.
If you notice schema discrepancies between the data dumps and the API, or if you need help with using our data dumps, please open an issue in the api-data
repo.
# Data Dumps vs. API?
We recommend using the data dumps for scenarios such as the following:
- You want to have a full copy of our data for archival purposes.
- You want to scrape a large result set (>10,000 records).
- You want to analyze or enhance our data.
Use our API if the following fits your use case:
- You want to integrate our data into a website or application.
- You need real-time access to our data.
# Scraping Data
Generally, we ask that you avoid extensive scraping of our API. The API is meant for direct integration into websites and applications. The data dumps are meant for backups and analysis. Scraping our API puts undue stress on our systems. Instead of scraping, please download the data dumps and filter them locally to obtain the data you need.
That said, we don't mind small-scale scraping of our API. It can be convenient to use our search endpoint to filter records and retrieve only the fields you need. You can even use the aggregation functionality of our search endpoints to run some simple analyses. Just remember that you cannot paginate beyond 10,000 results in our search endpoints (see Pagination).
If you do decide to scrape our resources, please throttle your requests to no more than one per second and avoid running multiple scrapers in parallel.
# Images
This API does not contain image files. However, it does contain all of the data you need to access our images. Our institution serves images via a separate API that is compliant with the IIIF Image API 2.0 specification. Using metadata from this API, you can craft URLs that will allow you to access images of artworks from our collection.
The International Image Interoperability Framework (IIIF) stewards a set of open standards that enables rich access to digital media from libraries, archives, museums, and other cultural institutions around the world. In practical terms, they define several API specifications that enable interoperability. When a tool is built to be IIIF-compliant, it's easier to adapt it to consume images from any number of institutions that offer IIIF-compliant APIs.
# IIIF Image API
We deliver our images via the IIIF Image API 2.0. Our IIIF URLs have the following structure:
https://www.artic.edu/iiif/2/{identifier}/{region}/{size}/{rotation}/{quality}.{format}
We recommend the following URL structure for most use-cases:
https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg
Let's jump right into an example. Here's how you can construct IIIF URLs:
Retrieve one or more artworks with
image_id
fields. Here are a few ways of doing so:# La Grande Jatte https://api.artic.edu/api/v1/artworks/27992?fields=id,title,image_id # La Grande Jatte and The Bedroom https://api.artic.edu/api/v1/artworks?ids=27992,28560&fields=id,title,image_id # Top two public domain artworks https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&limit=2&fields=id,title,image_id
Let's go with the first one, La Grande Jatte. Your response will look something like this:
{ "data": { "id": 27992, "title": "A Sunday on La Grande Jatte — 1884", "image_id": "1adf2696-8489-499b-cad2-821d7fde4b33" }, "config": { "iiif_url": "https://www.artic.edu/iiif/2", } }
Find the base IIIF Image API endpoint in the
config.iiif_url
field:https://www.artic.edu/iiif/2
We recommend that you avoid hardcoding this value into your applications.
Append the
image_id
of the artwork as a segment to this URL:https://www.artic.edu/iiif/2/1adf2696-8489-499b-cad2-821d7fde4b33
Append
/full/843,/0/default.jpg
to the URL:https://www.artic.edu/iiif/2/1adf2696-8489-499b-cad2-821d7fde4b33/full/843,/0/default.jpg
That's it! This is a valid IIIF URL. It will return the same image as we use on our website:
Some artworks also have alt_image_ids
, such as the Coronation Stone of Motecuhzoma II:
https://api.artic.edu/api/v1/artworks/75644?fields=id,title,image_id,alt_image_ids
Exhibitions have images, too:
https://api.artic.edu/api/v1/exhibitions/4568?fields=id,title,image_id,alt_image_ids
# Image Sizes
The IIIF Image API 2.0 has a lot of options. However, we prefer to use it conservatively. As mentioned above, here's the URL pattern we use for most projects:
https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg
We recommend using /full/843,/0/default.jpg
because this is the most common size used by our website, so there's a good chance that the image has previously been requested and cached. If you use this pattern in your projects, it will make images load faster in your application and decrease load on our systems.
TIP
We don't mind if you hotlink to our images. Our images support CORS with Access-Control-Allow-Origin: *
headers—same as our API responses! However, please be aware that any image can get unpublished or replaced at any time.
If you'd like to display the full image at smaller sizes, we recommend the following size increments, as these are likely to give you a cache hit as well:
https://www.artic.edu/iiif/2/{identifier}/full/200,/0/default.jpg
https://www.artic.edu/iiif/2/{identifier}/full/400,/0/default.jpg
https://www.artic.edu/iiif/2/{identifier}/full/600,/0/default.jpg
https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg
If you are accessing public domain images, you may also use the following pattern for larger images:
https://www.artic.edu/iiif/2/{identifier}/full/1686,/0/default.jpg
However, we still recommend using 843
instead unless there's a clear need for 1686
.
Why the strange number—843px wide? This number is related to certain guidelines for the use of copyrighted materials within the museum field. Over time, it became the most common dimension used by our applications, so it is the size we continue to recommend.
# IIIF Manifests
We also offer IIIF Manifests for all of our public domain artworks. A manifest is a resource defined by the IIIF Presentation API. Each manifest contains artwork metadata—such as title, artist name, and copyright info—alongside a list of images associated with that artwork.
You can access the manifest by appending /manifest.json
after the identifier in an artwork detail endpoint. For example, here is the manifest for The Great Wave:
https://api.artic.edu/api/v1/artworks/24645/manifest.json
These IIIF manifests do not contain any data that cannot be found elsewhere in our API. But because they follow a standardized API, they can be used with IIIF-compliant tools, such as Mirador. For a fun example, try pasting the URL above into the Getty's Animal Crossing Art Generator—and scroll up to see the result!
# Image Dumps
Unfortunately, we cannot offer image dumps at this time. We are exploring that possibility.
For now, you may scrape images from our IIIF Image API. We ask that you please follow our guidelines for scraping images if you decide to do so.
# Scraping Images
Generally, we prefer that you hotlink to our images, rather than scraping them. Scraping images can put unnecessary strain on our systems. That said, we understand that many use-cases require images to be stored locally.
If you'd like to scrape images from our IIIF API, please follow these guidelines:
- Scrape one image at a time—do not use multiple threads or processes!
- Consider adding a delay of 1 second between each image download
- Use the following URL pattern to download our most common image size:
https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg
# Copyright
For information about copyright, please see the Image Licensing and Terms pages on our website. We defer to those resources in all legal respects.
From a developer's perspective, we recommend only using images from artworks that are tagged as public domain. When querying for artworks, you can filter by public domain status like so:
https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&limit=0
To get the full list of artworks that are in the public domain, you will need to download our data dumps and perform the filtering locally.
Please note that you may encounter images that are not public domain via our IIIF Image API. It is up to you to determine whether or not you are allowed to use these images for your use-case and to obtain any necessary permissions.
# General Information
# Authentication
You may access our API without authentication. Anonymous users are throttled to 60 requests per minute. (Each IP counts as a separate user.) If you are working on an application that needs to exceed this restriction, please get in touch with us at engineering@artic.edu.
Please use HTTPS to access our API. To support legacy applications, our API is currently accessible via both HTTP and HTTPS, but HTTP access will be removed in the future.
Lastly, consider adding a AIC-User-Agent
header with the name of your project and a contact email to your API requests. For example:
curl 'https://api.artic.edu/api/v1/artworks/24645' \
--header 'AIC-User-Agent: aic-bash (engineering@artic.edu)'
We ask that you do so as a matter of courtesy. If we see an application using a disproportionate amount of system resources, this gives us an avenue to reach out and work with you to optimize your queries.
TIP
Why AIC-User-Agent
? Because modifying the User-Agent
header is forbidden by some browsers. We are using the AIC-
namespace to reduce potential conflicts with other applications (RFC 6648).
# Pagination
Listing and search endpoints are paginated. We show 12 records per page by default. Pagination can be controlled via the following query parameters:
page
to request a specific page of results (1-based, default: 1)limit
to set how many records each page should return (0-based, default: 12)
Example: https://api.artic.edu/api/v1/artists?page=2&limit=10
For performance reasons, limit
cannot exceed 100. Additionally, you cannot request more than 10,000 records from a single search query through any combination of limit
and page
. For example:
- Success: https://api.artic.edu/api/v1/artists/search?limit=100&page=100
- Error: https://api.artic.edu/api/v1/artists/search?limit=100&page=101
Generally, we ask that you avoid scraping our API. If you want to filter and scrape our search results, but the number of results is greater than 10,000, you won't be able to scrape them fully. Instead, we recommend that you download our data dumps and perform your filtering locally.
Occasionally, it might be useful to check the total number of results without retrieving any data. Our API supports this by allowing you to make a request with limit=0
. For example, check pagination.total
of this query to see the number of public domain artworks in our API:
https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&limit=0
All paginated endpoints include a pagination
block in their responses:
{
"pagination": {
"total": 112773,
"limit": 12,
"offset": 24, // 0-based
"current_page": 3, // 1-based
"total_pages": 9398,
"prev_url": "https://api.artic.edu/api/v1/artworks?page=2&limit=12",
"next_url": "https://api.artic.edu/api/v1/artworks?page=4&limit=12"
},
"data": [
// ...
]
}
# Endpoints
# Collections
# Artworks
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /artworks
A list of all artworks sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resourceinclude
- A comma-separated list of subresource to embed in the returned resources. Available options are:artist_pivots
catalogue_pivots
dates
place_pivots
sites
Example request: https://api.artic.edu/api/v1/artworks?limit=2
{
"pagination": {
"total": 114008,
"limit": 2,
"offset": 0,
"total_pages": 57004,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/artworks?page=2&limit=2"
},
"data": [
{
"id": 242611,
"api_model": "artworks",
"api_link": "https://api.artic.edu/api/v1/artworks/242611",
"is_boosted": false,
"title": "Mirror Pieces Installation II",
"alt_titles": null,
...
},
{
"id": 157021,
"api_model": "artworks",
"api_link": "https://api.artic.edu/api/v1/artworks/157021",
"is_boosted": false,
"title": "\"Rock Crystal\" Vase",
"alt_titles": null,
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /artworks/search
Search artworks data in the aggregator. Artworks in the groups of essentials are boosted so they'll show up higher in results.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/artworks/search?q=monet
{
"preference": null,
"pagination": {
"total": 296,
"limit": 10,
"offset": 0,
"total_pages": 30,
"current_page": 1
},
"data": [
{
"_score": 249.32751,
"thumbnail": {
"alt_text": "Painting of a pond seen up close spotted with thickly painted pink and white water lilies and a shadow across the top third of the picture.",
"width": 8809,
"lqip": "data:image/gif;base64,R0lGODlhBQAFAPQAAEZcaFFfdVtqbk9ldFBlcVFocllrcFlrd11rdl9sdFZtf15wcWV0d2R2eGByfmd6eGl6e2t9elZxiGF4kWB4kmJ9kGJ8lWeCkWSAnQAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAFAAUAAAUVoJBADXI4TLRMWHU9hmRRCjAURBACADs=",
"height": 8461
},
"api_model": "artworks",
"is_boosted": true,
"api_link": "https://api.artic.edu/api/v1/artworks/16568",
"id": 16568,
"title": "Water Lilies",
"timestamp": "2021-03-22T03:02:21-05:00"
},
{
"_score": 231.00276,
"thumbnail": {
"alt_text": "Loosely painted image of an open-air train station. On the right, a parked train gives off an enormous plumb of white smoke, making the scene look as though it were full of clouds. A huddled mass of barely discernible people crowd around the train on both sides of the tracks. Blue, green, and gray tones dominate.",
"width": 6786,
"lqip": "data:image/gif;base64,R0lGODlhBwAFAPUAADU8QkROS0ZPU0hSVk1YXVFWUlBXXlFaWVNcWFFkV1plVVtjWmBnWmFqXmRrX05ZYFFaYlljbF5qbGNsY2ZydmlzdWRxeGdze2l1fWx3fG16enJ4fH+KioWOkZeam5yjqZ2lqrG1ubS6vwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAHAAUAAAYhQIKmYslQDoONp8ORBECi0OfyKEAMmAhAgFhMHA2GIhEEADs=",
"height": 5092
},
"api_model": "artworks",
"is_boosted": true,
"api_link": "https://api.artic.edu/api/v1/artworks/16571",
"id": 16571,
"title": "Arrival of the Normandy Train, Gare Saint-Lazare",
"timestamp": "2021-03-22T03:02:21-05:00"
},
{
"_score": 228.45622,
"thumbnail": {
"alt_text": "Painting composed of short, dense brushstrokes depicts two domed stacks of wheat that cast long shadows on a field. The angled light indicates either a rising or setting sun.",
"width": 6884,
"lqip": "data:image/gif;base64,R0lGODlhCAAFAPUAAF5eVW1bVm9eVmpjW3RoXXxyV39yXmdsZmhmaXZtbG11eH57eYl5bYR7dHuAf4mDfo6HfpePdpCFeZSOfJ+VdnZ+g4ODgoCHg4iHgo+GgY2MgpmThJeTipaSjaCcmbWnh6qrpKmopqqtrKusrbGxobq4pLu5qq2zsQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAIAAUAAAYlwJNoFAKRSiZPh7OZRCgfBWJwAAQEBU2D8VgkCAYI5uKoWDKSIAA7",
"height": 4068
},
"api_model": "artworks",
"is_boosted": true,
"api_link": "https://api.artic.edu/api/v1/artworks/64818",
"id": 64818,
"title": "Stacks of Wheat (End of Summer)",
"timestamp": "2021-03-22T03:09:46-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /artworks/{id}
A single artwork by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/artworks/4
{
"data": {
"id": 4,
"api_model": "artworks",
"api_link": "https://api.artic.edu/api/v1/artworks/4",
"is_boosted": false,
"title": "Priest and Boy",
"alt_titles": null,
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /artworks/{id}/manifest[.json]
A representation of this artwork in the IIIF Presentation API format.
Example request: https://api.artic.edu/api/v1/artworks/4/manifest.json
{
"@context": "http://iiif.io/api/presentation/2/context.json",
"@id": "https://api.artic.edu/api/v1/artworks/4/manifest.json",
"@type": "sc:Manifest",
"label": "Priest and Boy",
"description": [
{
"value": "",
"language": "en"
}
],
"metadata": [
{
"label": "Artist / Maker",
"value": "Lawrence Carmichael Earle\nAmerican, 1845-1921"
},
{
"label": "Medium",
"value": "Watercolor over graphite on cream wove paper"
},
{
"label": "Dimensions",
"value": "472 \u00d7 345 mm"
},
{
"label": "Object Number",
"value": "1880.1"
},
{
"label": "Collection",
"value": "<a href='https://www.artic.edu/collection' target='_blank'>Art Institute of Chicago</a>"
},
"..."
],
"attribution": "Digital image courtesy of the Art Institute of Chicago.",
"logo": "https://raw.githubusercontent.com/Art-Institute-of-Chicago/template/master/aic-logo.gif",
"within": "https://www.artic.edu/collection",
"rendering": {
"@id": "https://www.artic.edu/artworks/4",
"format": "text/html",
"label": "Full record"
},
"sequences": [
{
"@type": "sc:Sequence",
"canvases": [
{
"@type": "sc:Canvas",
"@id": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f",
"label": "Priest and Boy, n.d.. Lawrence Carmichael Earle, American, 1845-1921",
"width": 843,
"height": 1162,
"images": [
{
"@type": "oa:Annotation",
"motivation": "sc:painting",
"on": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f",
"resource": {
"@type": "dctypes:Image",
"@id": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f/full/843,/0/default.jpg",
"width": 843,
"height": 1162,
"service": {
"@context": "http://iiif.io/api/image/2/context.json",
"@id": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f",
"profile": "http://iiif.io/api/image/2/level2.json"
}
}
}
]
}
]
},
"..."
]
}
# Agents
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /agents
A list of all agents sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resourceinclude
- A comma-separated list of subresource to embed in the returned resources. Available options are:sites
place_pivots
Example request: https://api.artic.edu/api/v1/agents?limit=2
{
"pagination": {
"total": 14177,
"limit": 2,
"offset": 0,
"total_pages": 7089,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/agents?page=2&limit=2"
},
"data": [
{
"id": 117464,
"api_model": "agents",
"api_link": "https://api.artic.edu/api/v1/agents/117464",
"title": "Pietro Malombra",
"sort_title": "Malombra, Pietro",
"alt_titles": null,
...
},
{
"id": 105683,
"api_model": "agents",
"api_link": "https://api.artic.edu/api/v1/agents/105683",
"title": "Lelooska",
"sort_title": "Lelooska",
"alt_titles": [
"Don Lelooska",
"Don Smith, (Lelooska)",
"Don Smith (Lelooska)"
],
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /agents/search
Search agents data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/agents/search
{
"preference": null,
"pagination": {
"total": 14462,
"limit": 10,
"offset": 0,
"total_pages": 1447,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "agents",
"api_link": "https://aggregator-data.artic.edu/api/v1/agents/60368",
"id": 60368,
"title": "Faith Wilding",
"timestamp": "2020-05-18T04:01:24-05:00"
},
{
"_score": 1,
"api_model": "agents",
"api_link": "https://aggregator-data.artic.edu/api/v1/agents/115891",
"id": 115891,
"title": "Adam Pendleton",
"timestamp": "2020-05-18T04:05:02-05:00"
},
{
"_score": 1,
"api_model": "agents",
"api_link": "https://api.artic.edu/api/v1/agents/1213",
"id": 1213,
"title": "Jean Michel Atlan",
"timestamp": "2021-03-22T03:34:54-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /agents/{id}
A single agent by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/agents/2
{
"data": {
"id": 2,
"api_model": "agents",
"api_link": "https://api.artic.edu/api/v1/agents/2",
"title": "Antiquarian Society",
"sort_title": "Antiquarian Society",
"alt_titles": [
"Art Institute of Chicago Antiquarian Society",
"A.I.C. Antiquarian Society"
],
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Places
The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.
# GET /places
A list of all places sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/places?limit=2
{
"pagination": {
"total": 3928,
"limit": 2,
"offset": 0,
"total_pages": 1964,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/places?page=2&limit=2"
},
"data": [
{
"id": -2147479000,
"api_model": "places",
"api_link": "https://api.artic.edu/api/v1/places/-2147479000",
"title": "B\u00e4stad",
"type": "No location",
"last_updated_source": "2020-12-10T06:43:10-06:00",
...
},
{
"id": -2147473257,
"api_model": "places",
"api_link": "https://api.artic.edu/api/v1/places/-2147473257",
"title": "Kinngait",
"type": "No location",
"last_updated_source": "2020-12-04T04:27:49-06:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
"license_links": [
"https://www.artic.edu/terms",
"https://creativecommons.org/licenses/by/4.0/"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /places/search
Search places data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/places/search
{
"preference": null,
"pagination": {
"total": 3951,
"limit": 10,
"offset": 0,
"total_pages": 396,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "places",
"api_link": "https://api.artic.edu/api/v1/places/-2147483613",
"id": -2147483613,
"title": "Peoria",
"timestamp": "2021-03-22T03:36:21-05:00"
},
{
"_score": 1,
"api_model": "places",
"api_link": "https://api.artic.edu/api/v1/places/-2147483581",
"id": -2147483581,
"title": "Askov",
"timestamp": "2021-03-22T03:36:21-05:00"
},
{
"_score": 1,
"api_model": "places",
"api_link": "https://api.artic.edu/api/v1/places/-2147483534",
"id": -2147483534,
"title": "Z\u00fcrich",
"timestamp": "2021-03-22T03:36:21-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
"license_links": [
"https://www.artic.edu/terms",
"https://creativecommons.org/licenses/by/4.0/"
],
"version": "1.0"
}
}
# GET /places/{id}
A single place by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/places/-2147483613
{
"data": {
"id": -2147483613,
"api_model": "places",
"api_link": "https://api.artic.edu/api/v1/places/-2147483613",
"title": "Peoria",
"type": "No location",
"last_updated_source": "1976-09-02T06:20:00-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
"license_links": [
"https://www.artic.edu/terms",
"https://creativecommons.org/licenses/by/4.0/"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Galleries
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /galleries
A list of all galleries sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/galleries?limit=2
{
"pagination": {
"total": 180,
"limit": 2,
"offset": 0,
"total_pages": 90,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/galleries?page=2&limit=2"
},
"data": [
{
"id": 23967,
"api_model": "galleries",
"api_link": "https://api.artic.edu/api/v1/galleries/23967",
"title": "Gallery 283",
"type": "AIC Gallery",
"is_closed": false,
...
},
{
"id": 2147483621,
"api_model": "galleries",
"api_link": "https://api.artic.edu/api/v1/galleries/2147483621",
"title": "Gallery 214",
"type": "AIC Gallery",
"is_closed": true,
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /galleries/search
Search galleries data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/galleries/search
{
"preference": null,
"pagination": {
"total": 180,
"limit": 10,
"offset": 0,
"total_pages": 18,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "galleries",
"api_link": "https://api.artic.edu/api/v1/galleries/2",
"id": 2,
"title": "East Garden at Columbus Drive",
"timestamp": "2021-03-22T03:36:24-05:00"
},
{
"_score": 1,
"api_model": "galleries",
"api_link": "https://api.artic.edu/api/v1/galleries/346",
"id": 346,
"title": "Stock Exchange Trading Room",
"timestamp": "2021-03-22T03:36:24-05:00"
},
{
"_score": 1,
"api_model": "galleries",
"api_link": "https://api.artic.edu/api/v1/galleries/2705",
"id": 2705,
"title": "Gallery 59",
"timestamp": "2021-03-22T03:36:24-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /galleries/{id}
A single gallery by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/galleries/2
{
"data": {
"id": 2,
"api_model": "galleries",
"api_link": "https://api.artic.edu/api/v1/galleries/2",
"title": "East Garden at Columbus Drive",
"type": "AIC Gallery",
"is_closed": false,
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Exhibitions
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /exhibitions
A list of all exhibitions sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resourceinclude
- A comma-separated list of subresource to embed in the returned resources. Available options are:artworks
sites
Example request: https://api.artic.edu/api/v1/exhibitions?limit=2
{
"pagination": {
"total": 6395,
"limit": 2,
"offset": 0,
"total_pages": 3198,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/exhibitions?page=2&limit=2"
},
"data": [
{
"id": 1664,
"api_model": "exhibitions",
"api_link": "https://api.artic.edu/api/v1/exhibitions/1664",
"title": "Danh Vo: We the People",
"is_featured": false,
"is_published": false,
...
},
{
"id": 6,
"api_model": "exhibitions",
"api_link": "https://api.artic.edu/api/v1/exhibitions/6",
"title": "Watercolors by Winslow Homer: The Color of Light",
"is_featured": false,
"is_published": false,
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /exhibitions/search
Search exhibitions data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/exhibitions/search
{
"preference": null,
"pagination": {
"total": 6128,
"limit": 10,
"offset": 0,
"total_pages": 613,
"current_page": 1
},
"data": [
{
"_score": 6.647884,
"api_model": "exhibitions",
"api_link": "https://api.artic.edu/api/v1/exhibitions/2831",
"id": 2831,
"title": "Taoism and the Arts of China",
"timestamp": "2021-03-22T03:36:35-05:00"
},
{
"_score": 6.647884,
"api_model": "exhibitions",
"api_link": "https://api.artic.edu/api/v1/exhibitions/2834",
"id": 2834,
"title": "Beyond the Easel: Decorative Painting by Bonnard, Vuillard, Denis, and Roussel, 1890\u20131930",
"timestamp": "2021-03-22T03:36:35-05:00"
},
{
"_score": 6.647884,
"api_model": "exhibitions",
"api_link": "https://api.artic.edu/api/v1/exhibitions/2835",
"id": 2835,
"title": "Van Gogh and Gauguin: The Studio of the South",
"timestamp": "2021-03-22T03:36:35-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /exhibitions/{id}
A single exhibition by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/exhibitions/5
{
"data": {
"id": 5,
"api_model": "exhibitions",
"api_link": "https://api.artic.edu/api/v1/exhibitions/5",
"title": "Manet and the Sea",
"is_featured": false,
"is_published": true,
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Agent Types
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /agent-types
A list of all agent-types sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/agent-types?limit=2
{
"pagination": {
"total": 26,
"limit": 2,
"offset": 0,
"total_pages": 13,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/agent-types?page=2&limit=2"
},
"data": [
{
"id": 29,
"api_model": "agent-types",
"api_link": "https://api.artic.edu/api/v1/agent-types/29",
"title": "Artist Collaborative",
"last_updated_source": "2019-05-08T13:31:54-05:00",
"last_updated": "2019-05-09T12:01:08-05:00",
...
},
{
"id": 28,
"api_model": "agent-types",
"api_link": "https://api.artic.edu/api/v1/agent-types/28",
"title": "Nonprofit",
"last_updated_source": "2019-05-08T13:31:54-05:00",
"last_updated": "2019-05-09T12:01:08-05:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /agent-types/{id}
A single agent-type by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/agent-types/1
{
"data": {
"id": 1,
"api_model": "agent-types",
"api_link": "https://api.artic.edu/api/v1/agent-types/1",
"title": "Corporate Body",
"last_updated_source": "2019-05-08T13:31:53-05:00",
"last_updated": "2019-05-09T12:01:08-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Agent Roles
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /agent-roles
A list of all agent-roles sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/agent-roles?limit=2
{
"pagination": {
"total": 164,
"limit": 2,
"offset": 0,
"total_pages": 82,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/agent-roles?page=2&limit=2"
},
"data": [
{
"id": 434,
"api_model": "agent-roles",
"api_link": "https://api.artic.edu/api/v1/agent-roles/434",
"title": "Craftsperson",
"last_updated_source": "2020-06-24T11:02:14-05:00",
"last_updated": "2020-06-24T16:00:33-05:00",
...
},
{
"id": 574,
"api_model": "agent-roles",
"api_link": "https://api.artic.edu/api/v1/agent-roles/574",
"title": "File Transfer",
"last_updated_source": "2019-05-08T14:05:12-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /agent-roles/{id}
A single agent-role by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/agent-roles/1
{
"data": {
"id": 1,
"api_model": "agent-roles",
"api_link": "https://api.artic.edu/api/v1/agent-roles/1",
"title": "Collection",
"last_updated_source": "2019-05-08T14:05:07-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Agent Place Qualifiers
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /agent-place-qualifiers
A list of all agent-place-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/agent-place-qualifiers?limit=2
{
"pagination": {
"total": 0,
"limit": 2,
"offset": 0,
"total_pages": 1,
"current_page": 1
},
"data": [],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /agent-place-qualifiers/{id}
A single agent-place-qualifier by the given identifier. {id} is the identifier from our collections management system.
# Artwork Types
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /artwork-types
A list of all artwork-types sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/artwork-types?limit=2
{
"pagination": {
"total": 44,
"limit": 2,
"offset": 0,
"total_pages": 22,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/artwork-types?page=2&limit=2"
},
"data": [
{
"id": 48,
"api_model": "artwork-types",
"api_link": "https://api.artic.edu/api/v1/artwork-types/48",
"title": "Time Based Media",
"last_updated_source": "2020-05-04T07:25:27-05:00",
"last_updated": "2020-05-04T07:25:51-05:00",
...
},
{
"id": 47,
"api_model": "artwork-types",
"api_link": "https://api.artic.edu/api/v1/artwork-types/47",
"title": "Materials",
"last_updated_source": "2019-10-07T06:53:19-05:00",
"last_updated": "2019-10-07T06:56:21-05:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /artwork-types/{id}
A single artwork-type by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/artwork-types/1
{
"data": {
"id": 1,
"api_model": "artwork-types",
"api_link": "https://api.artic.edu/api/v1/artwork-types/1",
"title": "Painting",
"last_updated_source": "2019-05-08T14:03:58-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Artwork Place Qualifiers
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /artwork-place-qualifiers
A list of all artwork-place-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/artwork-place-qualifiers?limit=2
{
"pagination": {
"total": 15,
"limit": 2,
"offset": 0,
"total_pages": 8,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/artwork-place-qualifiers?page=2&limit=2"
},
"data": [
{
"id": 54,
"api_model": "artwork-place-qualifiers",
"api_link": "https://api.artic.edu/api/v1/artwork-place-qualifiers/54",
"title": "Artist's culture:",
"last_updated_source": "2020-04-14T04:36:05-05:00",
"last_updated": "2020-04-14T08:46:00-05:00",
...
},
{
"id": 55,
"api_model": "artwork-place-qualifiers",
"api_link": "https://api.artic.edu/api/v1/artwork-place-qualifiers/55",
"title": "Inhabited place:",
"last_updated_source": "2020-04-13T08:01:45-05:00",
"last_updated": "2020-04-13T08:05:56-05:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /artwork-place-qualifiers/{id}
A single artwork-place-qualifier by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/artwork-place-qualifiers/1
{
"data": {
"id": 1,
"api_model": "artwork-place-qualifiers",
"api_link": "https://api.artic.edu/api/v1/artwork-place-qualifiers/1",
"title": "Building address",
"last_updated_source": "2019-05-08T13:00:18-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Artwork Date Qualifiers
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /artwork-date-qualifiers
A list of all artwork-date-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/artwork-date-qualifiers?limit=2
{
"pagination": {
"total": 31,
"limit": 2,
"offset": 0,
"total_pages": 16,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/artwork-date-qualifiers?page=2&limit=2"
},
"data": [
{
"id": 62,
"api_model": "artwork-date-qualifiers",
"api_link": "https://api.artic.edu/api/v1/artwork-date-qualifiers/62",
"title": "Manufactured",
"last_updated_source": "2019-05-08T16:59:24-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
},
{
"id": 61,
"api_model": "artwork-date-qualifiers",
"api_link": "https://api.artic.edu/api/v1/artwork-date-qualifiers/61",
"title": "Delineated",
"last_updated_source": "2019-05-08T16:59:24-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /artwork-date-qualifiers/{id}
A single artwork-date-qualifier by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/artwork-date-qualifiers/1
{
"data": {
"id": 1,
"api_model": "artwork-date-qualifiers",
"api_link": "https://api.artic.edu/api/v1/artwork-date-qualifiers/1",
"title": "Cast",
"last_updated_source": "2019-05-08T16:59:23-05:00",
"last_updated": "2019-05-09T12:01:07-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Catalogues
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /catalogues
A list of all catalogues sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/catalogues?limit=2
{
"pagination": {
"total": 1102,
"limit": 2,
"offset": 0,
"total_pages": 551,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/catalogues?page=2&limit=2"
},
"data": [
{
"id": 537,
"api_model": "catalogues",
"api_link": "https://api.artic.edu/api/v1/catalogues/537",
"title": "Walch",
"last_updated_source": "2020-11-17T07:20:47-06:00",
"last_updated": "2020-11-17T07:25:42-06:00",
...
},
{
"id": 536,
"api_model": "catalogues",
"api_link": "https://api.artic.edu/api/v1/catalogues/536",
"title": "Chamberlain",
"last_updated_source": "2019-10-15T04:35:50-05:00",
"last_updated": "2019-10-15T04:36:17-05:00",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /catalogues/{id}
A single catalogue by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/catalogues/-2147483646
{
"data": {
"id": -2147483646,
"api_model": "catalogues",
"api_link": "https://api.artic.edu/api/v1/catalogues/-2147483646",
"title": "Bliss",
"last_updated_source": "2019-05-08T13:18:14-05:00",
"last_updated": "2019-05-09T12:01:08-05:00",
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Category Terms
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /category-terms
A list of all category-terms sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/category-terms?limit=2
{
"pagination": {
"total": 9224,
"limit": 2,
"offset": 0,
"total_pages": 4612,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/category-terms?page=2&limit=2"
},
"data": [
{
"id": "TM-14540",
"api_model": "category-terms",
"api_link": "https://api.artic.edu/api/v1/category-terms/TM-14540",
"title": "chintz",
"subtype": "style",
"parent_id": null,
...
},
{
"id": "TM-14539",
"api_model": "category-terms",
"api_link": "https://api.artic.edu/api/v1/category-terms/TM-14539",
"title": "chaise longue",
"subtype": "subject",
"parent_id": null,
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /category-terms/search
Search category-terms data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/category-terms/search
{
"preference": null,
"pagination": {
"total": 9161,
"limit": 10,
"offset": 0,
"total_pages": 917,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "category-terms",
"api_link": "https://api.artic.edu/api/v1/category-terms/PC-826",
"id": "PC-826",
"title": "AIC Archives",
"timestamp": "2021-03-22T03:37:26-05:00"
},
{
"_score": 1,
"api_model": "category-terms",
"api_link": "https://api.artic.edu/api/v1/category-terms/PC-827",
"id": "PC-827",
"title": "SAIC Alumni and Faculty",
"timestamp": "2021-03-22T03:37:26-05:00"
},
{
"_score": 1,
"api_model": "category-terms",
"api_link": "https://api.artic.edu/api/v1/category-terms/PC-829",
"id": "PC-829",
"title": "Latin American",
"timestamp": "2021-03-22T03:37:26-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /category-terms/{id}
A single category-term by the given identifier. {id} is the identifier from our collections management system.
Example request: https://api.artic.edu/api/v1/category-terms/PC-1
{
"data": {
"id": "PC-1",
"api_model": "category-terms",
"api_link": "https://api.artic.edu/api/v1/category-terms/PC-1",
"title": "Arts of Africa",
"subtype": "department",
"parent_id": null,
...
},
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Images
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /images
A list of all images sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/images?limit=2
{
"pagination": {
"total": 285577,
"limit": 2,
"offset": 0,
"total_pages": 142789,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/images?page=2&limit=2"
},
"data": [
{
"id": "6cc52ff7-1284-9013-02a0-97bb272bf0ef",
"lake_guid": "6cc52ff7-1284-9013-02a0-97bb272bf0ef",
"api_model": "images",
"api_link": "https://api.artic.edu/api/v1/images/6cc52ff7-1284-9013-02a0-97bb272bf0ef",
"title": "PD_20283",
"type": "image",
...
},
{
"id": "a63b3e5f-beb3-7af2-af82-a4d3ee1b1f1c",
"lake_guid": "a63b3e5f-beb3-7af2-af82-a4d3ee1b1f1c",
"api_model": "images",
"api_link": "https://api.artic.edu/api/v1/images/a63b3e5f-beb3-7af2-af82-a4d3ee1b1f1c",
"title": "PD_20472",
"type": "image",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /images/search
Search images data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/images/search
{
"preference": null,
"pagination": {
"total": 288543,
"limit": 10,
"offset": 0,
"total_pages": 28855,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "images",
"api_link": "https://aggregator-data.artic.edu/api/v1/images/2231cdf1-d6ed-05cd-7ef8-66ab93dc8932",
"id": "2231cdf1-d6ed-05cd-7ef8-66ab93dc8932",
"title": "G00149",
"timestamp": "2020-05-18T04:24:04-05:00"
},
{
"_score": 1,
"api_model": "images",
"api_link": "https://aggregator-data.artic.edu/api/v1/images/2fd42dbf-1bca-06a5-4c8e-b82fc431a0e6",
"id": "2fd42dbf-1bca-06a5-4c8e-b82fc431a0e6",
"title": "E30137",
"timestamp": "2020-05-18T04:30:30-05:00"
},
{
"_score": 1,
"api_model": "images",
"api_link": "https://aggregator-data.artic.edu/api/v1/images/3f2f9f3d-5a59-8c6b-37fb-198cec93ba4d",
"id": "3f2f9f3d-5a59-8c6b-37fb-198cec93ba4d",
"title": "G00134",
"timestamp": "2020-05-18T04:37:40-05:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /images/{id}
A single image by the given identifier. {id} is the identifier from our collections management system.
# Videos
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /videos
A list of all videos sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/videos?limit=2
{
"pagination": {
"total": 4,
"limit": 2,
"offset": 0,
"total_pages": 2,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/videos?page=2&limit=2"
},
"data": [
{
"id": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
"lake_guid": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
"api_model": "videos",
"api_link": "https://api.artic.edu/api/v1/videos/c051f71e-2b69-ac68-9aa8-99410d91f3f3",
"title": "Under Cover: The Science of Van Gogh's Bedroom",
"type": "video",
...
},
{
"id": "eb06edce-6f2e-727c-0cee-a32cef589911",
"lake_guid": "eb06edce-6f2e-727c-0cee-a32cef589911",
"api_model": "videos",
"api_link": "https://api.artic.edu/api/v1/videos/eb06edce-6f2e-727c-0cee-a32cef589911",
"title": "A Thousand and One Swabs: The Transformation of \"Paris Street; Rainy Day\"",
"type": "video",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /videos/search
Search videos data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/videos/search
{
"preference": null,
"pagination": {
"total": 4,
"limit": 10,
"offset": 0,
"total_pages": 1,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "videos",
"api_link": "https://api.artic.edu/api/v1/videos/1ee4a231-0dad-2638-24fd-dfa2138eb142",
"id": "1ee4a231-0dad-2638-24fd-dfa2138eb142",
"title": "Digital Simulation: Original appearance of <em>For to Be a Farmer's Boy</em>",
"timestamp": "2021-01-13T04:24:59-06:00"
},
{
"_score": 1,
"api_model": "videos",
"api_link": "https://api.artic.edu/api/v1/videos/c051f71e-2b69-ac68-9aa8-99410d91f3f3",
"id": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
"title": "Under Cover: The Science of Van Gogh's Bedroom",
"timestamp": "2021-01-13T04:24:59-06:00"
},
{
"_score": 1,
"api_model": "videos",
"api_link": "https://api.artic.edu/api/v1/videos/c5700df1-473c-c1cd-ab1b-79b20a32fc27",
"id": "c5700df1-473c-c1cd-ab1b-79b20a32fc27",
"title": "Online Game: Winslow Homer's <em>The Water Fan</em>",
"timestamp": "2021-01-13T04:24:59-06:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /videos/{id}
A single video by the given identifier. {id} is the identifier from our collections management system.
# Sounds
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /sounds
A list of all sounds sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/sounds?limit=2
{
"pagination": {
"total": 1908,
"limit": 2,
"offset": 0,
"total_pages": 954,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/sounds?page=2&limit=2"
},
"data": [
{
"id": "fcb1b4d0-e285-7e45-5459-138fe3ce2abf",
"lake_guid": "fcb1b4d0-e285-7e45-5459-138fe3ce2abf",
"api_model": "sounds",
"api_link": "https://api.artic.edu/api/v1/sounds/fcb1b4d0-e285-7e45-5459-138fe3ce2abf",
"title": "Audio stop 986.mp3",
"type": "sound",
...
},
{
"id": "f076abd9-6d6f-1a9a-e1b3-2bde776e9e82",
"lake_guid": "f076abd9-6d6f-1a9a-e1b3-2bde776e9e82",
"api_model": "sounds",
"api_link": "https://api.artic.edu/api/v1/sounds/f076abd9-6d6f-1a9a-e1b3-2bde776e9e82",
"title": "Audio stop 989.mp3",
"type": "sound",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /sounds/search
Search sounds data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/sounds/search
{
"preference": null,
"pagination": {
"total": 1909,
"limit": 10,
"offset": 0,
"total_pages": 191,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "sounds",
"api_link": "https://api.artic.edu/api/v1/sounds/2fffdf0d-39f1-d0bd-712c-791a0fe12d9e",
"id": "2fffdf0d-39f1-d0bd-712c-791a0fe12d9e",
"title": "Audio stop 623.mp3",
"timestamp": "2021-01-13T04:25:03-06:00"
},
{
"_score": 1,
"api_model": "sounds",
"api_link": "https://api.artic.edu/api/v1/sounds/30198693-76a0-5adc-e753-2de5a418a5fd",
"id": "30198693-76a0-5adc-e753-2de5a418a5fd",
"title": "Audio stop 910.mp3",
"timestamp": "2021-01-13T04:25:03-06:00"
},
{
"_score": 1,
"api_model": "sounds",
"api_link": "https://api.artic.edu/api/v1/sounds/30d4cfab-2e68-be75-cc5c-8207fd459cb1",
"id": "30d4cfab-2e68-be75-cc5c-8207fd459cb1",
"title": "Audio stop 91.mp3",
"timestamp": "2021-01-13T04:25:03-06:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /sounds/{id}
A single sound by the given identifier. {id} is the identifier from our collections management system.
# Texts
The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.
# GET /texts
A list of all texts sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/texts?limit=2
{
"pagination": {
"total": 5899,
"limit": 2,
"offset": 0,
"total_pages": 2950,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/texts?page=2&limit=2"
},
"data": [
{
"id": "94fa5de6-38e4-0159-2d96-33266855e4de",
"lake_guid": "94fa5de6-38e4-0159-2d96-33266855e4de",
"api_model": "texts",
"api_link": "https://api.artic.edu/api/v1/texts/94fa5de6-38e4-0159-2d96-33266855e4de",
"title": "1970_Photographs_by_Euge_ne_Atget_Installation_Photos_2.pdf",
"type": "text",
...
},
{
"id": "d23c19b1-e9b6-60e3-dcf9-c240c3996fa0",
"lake_guid": "d23c19b1-e9b6-60e3-dcf9-c240c3996fa0",
"api_model": "texts",
"api_link": "https://api.artic.edu/api/v1/texts/d23c19b1-e9b6-60e3-dcf9-c240c3996fa0",
"title": "1970_Photographs_by_Euge_ne_Atget_Installation_Photos_5.pdf",
"type": "text",
...
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /texts/search
Search texts data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/texts/search
{
"preference": null,
"pagination": {
"total": 5911,
"limit": 10,
"offset": 0,
"total_pages": 592,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "texts",
"api_link": "https://api.artic.edu/api/v1/texts/34633f5d-d90c-5b05-3e37-b009698e4243",
"id": "34633f5d-d90c-5b05-3e37-b009698e4243",
"title": "Audio transcript 590.txt",
"timestamp": "2020-12-11T09:21:42-06:00"
},
{
"_score": 1,
"api_model": "texts",
"api_link": "https://api.artic.edu/api/v1/texts/0ce7c09b-72fa-2879-0e4a-f460a04276aa",
"id": "0ce7c09b-72fa-2879-0e4a-f460a04276aa",
"title": "Audio Transcript 957.txt",
"timestamp": "2021-01-13T04:25:07-06:00"
},
{
"_score": 1,
"api_model": "texts",
"api_link": "https://api.artic.edu/api/v1/texts/0ce9f003-fa67-e2c9-bcd5-33d3196510fa",
"id": "0ce9f003-fa67-e2c9-bcd5-33d3196510fa",
"title": "AIC1921APoole_comb.pdf",
"timestamp": "2021-01-13T04:25:07-06:00"
}
],
"info": {
"license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
"license_links": [
"https://creativecommons.org/publicdomain/zero/1.0/",
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /texts/{id}
A single text by the given identifier. {id} is the identifier from our collections management system.
# Shop
# Products
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /products
A list of all products sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/products?limit=2
{
"pagination": {
"total": 7374,
"limit": 2,
"offset": 0,
"total_pages": 3687,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/products?page=2&limit=2"
},
"data": [
{
"id": 8366,
"api_model": "products",
"api_link": "https://api.artic.edu/api/v1/products/8366",
"title": "TEE HOPPER NIGHTHAWKS XXL",
"external_sku": 283125,
"image_url": "https://shop-images.imgix.net283125_2.jpg",
...
},
{
"id": 8365,
"api_model": "products",
"api_link": "https://api.artic.edu/api/v1/products/8365",
"title": "TEE HOPPER NIGHTHAWKS L",
"external_sku": 283123,
"image_url": "https://shop-images.imgix.net283123_2.jpg",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /products/search
Search products data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/products/search
{
"preference": null,
"pagination": {
"total": 0,
"limit": 10,
"offset": 0,
"total_pages": 0,
"current_page": 1
},
"data": [],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /products/{id}
A single product by the given identifier.
Example request: https://api.artic.edu/api/v1/products/37
{
"data": {
"id": 37,
"api_model": "products",
"api_link": "https://api.artic.edu/api/v1/products/37",
"title": "Sullivan Scarf",
"external_sku": 265543,
"image_url": "https://shop-images.imgix.net265543_2.jpg",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Mobile
# Tours
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /tours
A list of all tours sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resourceinclude
- A comma-separated list of subresource to embed in the returned resources. Available options are:tour_stops
Example request: https://api.artic.edu/api/v1/tours?limit=2
{
"pagination": {
"total": 16,
"limit": 2,
"offset": 0,
"total_pages": 8,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/tours?page=2&limit=2"
},
"data": [
{
"id": 1000,
"api_model": "tours",
"api_link": "https://api.artic.edu/api/v1/tours/1000",
"title": "Magic of the Miniature",
"image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/E17048_reduced.jpg",
"description": "<p>Travel back in time through the magic of the Thorne Rooms.</p>\n",
...
},
{
"id": 1023,
"api_model": "tours",
"api_link": "https://api.artic.edu/api/v1/tours/1023",
"title": "The Architecture Tour",
"image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/IM016907_008_reduced.jpg",
"description": "<p>Uncover the secrets of the museum\u2019s storied architecture.</p>\n",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /tours/search
Search tours data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/tours/search
{
"preference": null,
"pagination": {
"total": 21,
"limit": 10,
"offset": 0,
"total_pages": 3,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "tours",
"api_link": "https://aggregator-data.artic.edu/api/v1/tours/4581",
"id": 4581,
"title": "In a Cloud, in a Wall, in a Chair: Six Modernists in Mexico at Midcentury",
"timestamp": "2020-03-06T06:10:23-06:00"
},
{
"_score": 1,
"api_model": "tours",
"api_link": "https://aggregator-data.artic.edu/api/v1/tours/4626",
"id": 4626,
"title": "Andy Warhol\u2014From A to B and Back Again",
"timestamp": "2020-03-06T06:10:23-06:00"
},
{
"_score": 1,
"api_model": "tours",
"api_link": "https://aggregator-data-dev.artic.edu/api/v1/tours/4636",
"id": 4636,
"title": "MD Test Tour",
"timestamp": "2019-12-05T11:00:47-06:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /tours/{id}
A single tour by the given identifier.
Example request: https://api.artic.edu/api/v1/tours/1000
{
"data": {
"id": 1000,
"api_model": "tours",
"api_link": "https://api.artic.edu/api/v1/tours/1000",
"title": "Magic of the Miniature",
"image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/E17048_reduced.jpg",
"description": "<p>Travel back in time through the magic of the Thorne Rooms.</p>\n",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Mobile Sounds
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /mobile-sounds
A list of all mobile-sounds sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/mobile-sounds?limit=2
{
"pagination": {
"total": 792,
"limit": 2,
"offset": 0,
"total_pages": 396,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/mobile-sounds?page=2&limit=2"
},
"data": [
{
"id": 4732,
"api_model": "mobile-sounds",
"api_link": "https://api.artic.edu/api/v1/mobile-sounds/4732",
"title": "Vase (Maebyong) with Clouds, Flying Cranes, and Children amid Bamboo",
"web_url": "https://www.artic.edu/mobile/audio/1950.1626_KoreanVase_V4.mp3",
"transcript": "<p>There are a lot of celedons in our collection, but some are better than the others.</p>\n<p>My name is Yeonsoo Chee, I\u2019m an Associate Curator at the Art Institute of Chicago.</p>\n<p>There\u2019s kind of an even coloration, and also the thickness of the glaze is very even, so you don\u2019t see that some parts are shinier than the others. The technique decorating this vase is called the \u201csanggam\u201d technique. The most common techniques to decorate the ceramics were either to paint or incise designs. But the sanggam, actually, is more involved than any of these two techniques. The potter will carve out the space to create the design and then he will fill those negative spaces with white clay or white slip. Then, after it\u2019s dried, he will carve out the next details that we see in black, and then he will fill that space with red clay this time. These white parts stay white and then the red parts turn into black. So, now we see two different colorations from the motifs.</p>\n<p>Usually, the motifs in Asian art, they are not accidental\u2014they all carry very specific meanings. Cranes represent longevity. When there are children, it means the wish for fertility and a lot of offspring. And bamboo is one of the four friends of the gentlemen\u2014it is known as \u201cSagunja\u201d in Korean and also it is very common in Chinese art, too. Bamboo represents the integrity and resilience because bamboo is evergreen, they don\u2019t change. And then they are very hard to be broken. So, along with the plum, orchids, and chrysanthemum, these four represent the virtues that scholar gentlemen should have.</p>\n<p>So I think those kinds of consistencies in terms of coloration and also the execution of the design\u2014those things make this piece stand out among others.</p>\n",
...
},
{
"id": 4722,
"api_model": "mobile-sounds",
"api_link": "https://api.artic.edu/api/v1/mobile-sounds/4722",
"title": "T036_MonetIntro_V4.mp3 (Monet and Chicago)",
"web_url": "https://www.artic.edu/mobile/audio/00_MonetIntroduction_V4.mp3",
"transcript": "<p>Gloria Groom: Welcome! My name is Gloria Groom and I\u2019m Chair of the Department of European Painting and Sculpture. We\u2019re really excited to be presenting the Monet exhibition. We have had Monet exhibitions in the past but this is the first time to really focus on the artist and his impact on the city of Chicago and at the Art Institute. We\u2019ll be talking about those important early collectors of Monet\u2014the Palmers, the Ryersons, the Coburns\u2014and, of course, other collectors throughout the 20th century. But we also want to be able to reveal some of the discoveries that have been made in the Conservation Lab with conservators and curators and art historians as we\u2019ve looked very deeply and closely at his paintings. It\u2019s really a celebration of the artist but also the history we\u2019ve had with the artist in the city of Chicago.</p>\n<p>So in the next room what you\u2019ll see are photographs of the three most important collectors of Monet early on\u2014how they lived with his paintings, how they looked, a little biography on them\u2014to really get you into the story that Monet was not necessarily a household name but he was certainly appreciated by the leaders of the Chicago cultural life of that time.</p>\n",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /mobile-sounds/search
Search mobile-sounds data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/mobile-sounds/search
{
"preference": null,
"pagination": {
"total": 794,
"limit": 10,
"offset": 0,
"total_pages": 80,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "mobile-sounds",
"api_link": "https://aggregator-data-dev.artic.edu/api/v1/mobile-sounds/4528",
"id": 4528,
"title": "Statue of a Young Satyr Wearing a Theater Mask of Silenos",
"timestamp": "2019-12-05T11:00:45-06:00"
},
{
"_score": 1,
"api_model": "mobile-sounds",
"api_link": "https://aggregator-data-dev.artic.edu/api/v1/mobile-sounds/4637",
"id": 4637,
"title": "Intro",
"timestamp": "2019-12-05T11:00:46-06:00"
},
{
"_score": 1,
"api_model": "mobile-sounds",
"api_link": "https://api.artic.edu/api/v1/mobile-sounds/226",
"id": 226,
"title": "Justus Sustermans",
"timestamp": "2021-03-22T03:51:02-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /mobile-sounds/{id}
A single mobile-sound by the given identifier.
Example request: https://api.artic.edu/api/v1/mobile-sounds/226
{
"data": {
"id": 226,
"api_model": "mobile-sounds",
"api_link": "https://api.artic.edu/api/v1/mobile-sounds/226",
"title": "Justus Sustermans",
"web_url": "https://www.artic.edu/mobile/audio/882.mp3",
"transcript": "<p>VICTORIA SANCHO LOBIS: Portrait prints had been made since the beginning of the history of the print. But they typically were used to represent political figures or scholars.</p>\n<p>NARRATOR: Until Van Dyck\u2019 created the Iconography. In this series of prints he not only included political leaders and other renowned citizens, but artists as well, signaling their growing importance in 17th century European society. The Art Institute is fortunate to own all of Van Dyck\u2019s etchings for this project, and they are exhibited here for the first time in almost a century.</p>\n<p>The artist began the series by casually creating 15 portraits, expecting that expert printmakers would finish his plates. He could hardly have anticipated the interest these \u2018unfinished\u2019 prints would generate.</p>\n<p>In this portrait of artist Justus Sustermans, Van Dyck paid great attention to detail in his sitter\u2019s face.</p>\n<p>VICTORIA SANCHO LOBIS: And then from there, the description of the sitter becomes increasingly abstract. And we eventually get to the painter\u2019s right hand, which is drawn in with just the most preliminary and rudimentary lines, sort of square-shaped fingertips, and no shading whatsoever.</p>\n<p>NARRATOR: This contrast between detailed depiction and imaginative abstraction is precisely what caught a collector\u2019s eye and what still seems so modern about Van Dyck\u2019s etchings today. Van Dyck\u2019s self-portrait is probably the first unfinished print ever to have been produced in an edition.</p>\n<p>VICTORIA SANCHO LOBIS: Like most of the etchings that Van Dyck made, this print shows the effects of an imperfectly polished copper plate. So we see scratches, particularly in the upper register. There\u2019s various other passages where a more conscientious printmaker would have taken pains to remove blemishes or imperfections. But these seemed not to bother Van Dyck very much, nor did it bother some of the early collectors.</p>\n<p>NARRATOR: Those collectors immediately embraced van Dyck\u2019s revolutionary portraiture, eagerly purchasing new prints for their collections. Nearby, you\u2019ll see other unfinished portraits van Dyck created for the series.</p>\n",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Digital Scholarly Catalogs
# Publications
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /publications
A list of all publications sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/publications?limit=2
{
"pagination": {
"total": 12,
"limit": 2,
"offset": 0,
"total_pages": 6,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/publications?page=2&limit=2"
},
"data": [
{
"id": 141096,
"api_model": "publications",
"api_link": "https://api.artic.edu/api/v1/publications/141096",
"title": "Gauguin Paintings, Sculpture, and Graphic Works at the Art Institute of Chicago",
"web_url": "https://publications.artic.edu/gauguin/reader/gauguinart",
"site": "gauguin",
...
},
{
"id": 140019,
"api_model": "publications",
"api_link": "https://api.artic.edu/api/v1/publications/140019",
"title": "Manet Paintings and Works on Paper at the Art Institute of Chicago",
"web_url": "https://publications.artic.edu/manet/reader/manetart",
"site": "manet",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /publications/search
Search publications data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/publications/search
{
"preference": null,
"pagination": {
"total": 12,
"limit": 10,
"offset": 0,
"total_pages": 2,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "publications",
"api_link": "https://api.artic.edu/api/v1/publications/2",
"id": 2,
"title": "American Silver in the Art Institute of Chicago",
"timestamp": "2021-03-22T03:51:06-05:00"
},
{
"_score": 1,
"api_model": "publications",
"api_link": "https://api.artic.edu/api/v1/publications/7",
"id": 7,
"title": "Pissarro Paintings and Works on Paper at the Art Institute of Chicago",
"timestamp": "2021-03-22T03:51:06-05:00"
},
{
"_score": 1,
"api_model": "publications",
"api_link": "https://api.artic.edu/api/v1/publications/12",
"id": 12,
"title": "The Modern Series at the Art Institute of Chicago",
"timestamp": "2021-03-22T03:51:06-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /publications/{id}
A single publication by the given identifier.
Example request: https://api.artic.edu/api/v1/publications/2
{
"data": {
"id": 2,
"api_model": "publications",
"api_link": "https://api.artic.edu/api/v1/publications/2",
"title": "American Silver in the Art Institute of Chicago",
"web_url": "https://publications.artic.edu/americansilver/reader/collection",
"site": "americansilver",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Sections
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /sections
A list of all sections sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/sections?limit=2
{
"pagination": {
"total": 1124,
"limit": 2,
"offset": 0,
"total_pages": 562,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/sections?page=2&limit=2"
},
"data": [
{
"id": 128775,
"api_model": "sections",
"api_link": "https://api.artic.edu/api/v1/sections/128775",
"title": "Bibliography",
"web_url": "https://publications.artic.edu/americansilver/reader/collection/section/504",
"accession": null,
...
},
{
"id": 108342,
"api_model": "sections",
"api_link": "https://api.artic.edu/api/v1/sections/108342",
"title": "Select Silver Objects in the Collection of the Art Institute of Chicago",
"web_url": "https://publications.artic.edu/americansilver/reader/collection/section/462",
"accession": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /sections/search
Search sections data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/sections/search
{
"preference": null,
"pagination": {
"total": 1124,
"limit": 10,
"offset": 0,
"total_pages": 113,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "sections",
"api_link": "https://api.artic.edu/api/v1/sections/36912890728",
"id": 36912890728,
"title": "Signatures",
"timestamp": "2021-03-22T03:51:15-05:00"
},
{
"_score": 1,
"api_model": "sections",
"api_link": "https://api.artic.edu/api/v1/sections/36941697573",
"id": 36941697573,
"title": "Mrs. Lewis Larned (Annie Swan) Coburn",
"timestamp": "2021-03-22T03:51:15-05:00"
},
{
"_score": 1,
"api_model": "sections",
"api_link": "https://api.artic.edu/api/v1/sections/36942241206",
"id": 36942241206,
"title": "Charles H. and Mary F. S. Worcester",
"timestamp": "2021-03-22T03:51:15-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /sections/{id}
A single section by the given identifier.
Example request: https://api.artic.edu/api/v1/sections/18
{
"data": {
"id": 18,
"api_model": "sections",
"api_link": "https://api.artic.edu/api/v1/sections/18",
"title": "Foreword",
"web_url": "https://publications.artic.edu/americansilver/reader/collection/section/3",
"accession": null,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Static Archive
# Sites
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /sites
A list of all sites sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resourceinclude
- A comma-separated list of subresource to embed in the returned resources. Available options are:artworks
Example request: https://api.artic.edu/api/v1/sites?limit=2
{
"pagination": {
"total": 93,
"limit": 2,
"offset": 0,
"total_pages": 47,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/sites?page=2&limit=2"
},
"data": [
{
"id": 104,
"api_model": "sites",
"api_link": "https://api.artic.edu/api/v1/sites/104",
"title": "Hugh Edwards",
"description": null,
"web_url": "http://archive.artic.edu/edwards/",
...
},
{
"id": 103,
"api_model": "sites",
"api_link": "https://api.artic.edu/api/v1/sites/103",
"title": "Edward Steichen's Work War I Years",
"description": "This website, which includes works drawn from the Art Institute\u2019s collection, reveals the profound influence Steichen had on various photographic fields. Featured is a unique album of World War I aerial photographs assembled and annotated by Steichen in 1919 following his military discharge.",
"web_url": "http://archive.artic.edu/steichen/",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /sites/search
Search sites data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/sites/search
{
"preference": null,
"pagination": {
"total": 93,
"limit": 10,
"offset": 0,
"total_pages": 10,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "sites",
"api_link": "https://api.artic.edu/api/v1/sites/1",
"id": 1,
"title": "Chicago Architecture: Ten Visions",
"timestamp": "2021-03-22T03:51:20-05:00"
},
{
"_score": 1,
"api_model": "sites",
"api_link": "https://api.artic.edu/api/v1/sites/2",
"id": 2,
"title": "American Perspectives: A yearlong celebration of American artistic vision",
"timestamp": "2021-03-22T03:51:20-05:00"
},
{
"_score": 1,
"api_model": "sites",
"api_link": "https://api.artic.edu/api/v1/sites/3",
"id": 3,
"title": "Curious Corner",
"timestamp": "2021-03-22T03:51:21-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /sites/{id}
A single site by the given identifier.
Example request: https://api.artic.edu/api/v1/sites/1
{
"data": {
"id": 1,
"api_model": "sites",
"api_link": "https://api.artic.edu/api/v1/sites/1",
"title": "Chicago Architecture: Ten Visions",
"description": "Chicago Architecture: Ten Visions presents diverse views of the future of Chicago\u2019s built environment from 10 internationally renowned architects. The architects were selected from an invited competition juried by architects Stanley Tigerman and Harry Cobb, in collaboration with curators from the Art Institute\u2019s Department of Architecture. The 10 architects reflect a cross section of Chicago\u2019s vibrant architectural scene\u2014from large and small firms as well as the academic community\u2014bringing to this exhibition diverse experiences and insights. Each architect was asked to define an important issue for the future of Chicago and create a \u201cspatial commentary\u201d on that particular theme. Within a lively plan designed by Stanley Tigerman, each of the participants has curated and designed his or her own mini-exhibition in a space of approximately 21 feet square. Tigerman\u2019s setting creates a linear sequence in which visitors pass through the architects\u2019 spaces to an interactive area where the architects\u2019 commentaries can be heard by picking up a telephone. Visitors are encouraged to record their comments on any and all of the \u201cten visions.\u201d",
"web_url": "http://archive.artic.edu/10visions/",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Website
# Closures
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /closures
A list of all closures sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/closures?limit=2
{
"pagination": {
"total": 34,
"limit": 2,
"offset": 0,
"total_pages": 17,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/closures?page=2&limit=2"
},
"data": [
{
"id": 38,
"api_model": "closures",
"api_link": "https://api.artic.edu/api/v1/closures/38",
"title": "Lorem ipsum.",
"date_start": "2020-09-22T00:00:00-05:00",
"date_end": "2020-09-23T00:00:00-05:00",
...
},
{
"id": 45,
"api_model": "closures",
"api_link": "https://api.artic.edu/api/v1/closures/45",
"title": "Lorem ipsum.",
"date_start": "2020-09-26T00:00:00-05:00",
"date_end": "2020-09-26T00:00:00-05:00",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /closures/search
Search closures data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/closures/search
{
"preference": null,
"pagination": {
"total": 27,
"limit": 10,
"offset": 0,
"total_pages": 3,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "closures",
"api_link": "https://api.artic.edu/api/v1/closures/4",
"id": 4,
"title": "Lorem ipsum.",
"timestamp": "2021-03-22T03:51:22-05:00"
},
{
"_score": 1,
"api_model": "closures",
"api_link": "https://api.artic.edu/api/v1/closures/5",
"id": 5,
"title": "Lorem ipsum.",
"timestamp": "2021-03-22T03:51:22-05:00"
},
{
"_score": 1,
"api_model": "closures",
"api_link": "https://api.artic.edu/api/v1/closures/9",
"id": 9,
"title": "Lorem ipsum.",
"timestamp": "2021-03-22T03:51:22-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /closures/{id}
A single closure by the given identifier.
Example request: https://api.artic.edu/api/v1/closures/4
{
"data": {
"id": 4,
"api_model": "closures",
"api_link": "https://api.artic.edu/api/v1/closures/4",
"title": "Lorem ipsum.",
"date_start": "2020-12-25T00:00:00-06:00",
"date_end": "2020-12-25T00:00:00-06:00",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Web Exhibitions
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /web-exhibitions
A list of all web-exhibitions sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/web-exhibitions?limit=2
{
"pagination": {
"total": 689,
"limit": 2,
"offset": 0,
"total_pages": 345,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/web-exhibitions?page=2&limit=2"
},
"data": [
{
"id": 66,
"api_model": "web-exhibitions",
"api_link": "https://api.artic.edu/api/v1/web-exhibitions/66",
"title": "Tools of the Trade: 19th- and 20th- Century Architectural Trade Catalogs",
"exhibition_id": 2999,
"is_featured": false,
...
},
{
"id": 60,
"api_model": "web-exhibitions",
"api_link": "https://api.artic.edu/api/v1/web-exhibitions/60",
"title": "The Modern Chair",
"exhibition_id": null,
"is_featured": false,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /web-exhibitions/search
Search web-exhibitions data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/web-exhibitions/search
{
"preference": null,
"pagination": {
"total": 699,
"limit": 10,
"offset": 0,
"total_pages": 70,
"current_page": 1
},
"data": [
{
"_score": 4.563684,
"api_model": "web-exhibitions",
"api_link": "https://api.artic.edu/api/v1/web-exhibitions/1",
"id": 1,
"title": "Charles White: A Retrospective",
"timestamp": "2021-03-22T03:51:22-05:00"
},
{
"_score": 4.563684,
"api_model": "web-exhibitions",
"api_link": "https://api.artic.edu/api/v1/web-exhibitions/2",
"id": 2,
"title": "Manet and Modern Beauty",
"timestamp": "2021-03-22T03:51:22-05:00"
},
{
"_score": 4.563684,
"api_model": "web-exhibitions",
"api_link": "https://api.artic.edu/api/v1/web-exhibitions/3",
"id": 3,
"title": "Andy Warhol\u2013From A to B and Back Again",
"timestamp": "2021-03-22T03:51:22-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /web-exhibitions/{id}
A single web-exhibition by the given identifier.
Example request: https://api.artic.edu/api/v1/web-exhibitions/1
{
"data": {
"id": 1,
"api_model": "web-exhibitions",
"api_link": "https://api.artic.edu/api/v1/web-exhibitions/1",
"title": "Charles White: A Retrospective",
"exhibition_id": 2663,
"is_featured": false,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Events
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /events
A list of all events sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resourceinclude
- A comma-separated list of subresource to embed in the returned resources. Available options are:email_series_pivots
sponsor
Example request: https://api.artic.edu/api/v1/events?limit=2
{
"pagination": {
"total": 2073,
"limit": 2,
"offset": 0,
"total_pages": 1037,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/events?page=2&limit=2"
},
"data": [
{
"id": 3972,
"api_model": "events",
"api_link": "https://api.artic.edu/api/v1/events/3972",
"title": "Concert: Thurston Moore Presents New Noise Guitar Explorations",
"title_display": null,
"published": true,
...
},
{
"id": 3927,
"api_model": "events",
"api_link": "https://api.artic.edu/api/v1/events/3927",
"title": "Concert: Sun Ra Arkestra",
"title_display": null,
"published": true,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /events/search
Search events data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/events/search
{
"preference": null,
"pagination": {
"total": 2010,
"limit": 10,
"offset": 0,
"total_pages": 201,
"current_page": 1
},
"data": [
{
"_score": 1.0656996,
"api_model": "events",
"api_link": "https://api.artic.edu/api/v1/events/4972",
"id": 4972,
"title": "Conversation: The Life Cycle of an El Greco Masterpiece\u2014POSTPONED",
"timestamp": "2021-03-22T03:51:32-05:00"
},
{
"_score": 1.0656996,
"api_model": "events",
"api_link": "https://api.artic.edu/api/v1/events/4974",
"id": 4974,
"title": "Performance: The Seldoms\u2014Floe",
"timestamp": "2021-03-22T03:51:32-05:00"
},
{
"_score": 1.0656996,
"api_model": "events",
"api_link": "https://api.artic.edu/api/v1/events/4975",
"id": 4975,
"title": "CANCELED | Performance: The Seldoms\u2014Floe",
"timestamp": "2021-03-22T03:51:32-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /events/{id}
A single event by the given identifier.
Example request: https://api.artic.edu/api/v1/events/4
{
"data": {
"id": 4,
"api_model": "events",
"api_link": "https://api.artic.edu/api/v1/events/4",
"title": "Member Preview: John Singer Sargent and Chicago\u2019s Gilded Age",
"title_display": null,
"published": true,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Event Occurrences
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /event-occurrences
A list of all event-occurrences sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/event-occurrences?limit=2
{
"pagination": {
"total": 19,
"limit": 2,
"offset": 0,
"total_pages": 10,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/event-occurrences?page=2&limit=2"
},
"data": [
{
"id": "178b4bfc-a4cb-5739-83ce-113bde6f45c5",
"api_model": "event-occurrences",
"api_link": "https://api.artic.edu/api/v1/event-occurrences/178b4bfc-a4cb-5739-83ce-113bde6f45c5",
"title": "Virtual Reading and Conversation: Jenny Offill and Ling Ma",
"event_id": 5138,
"short_description": "Authors Jenny Offill and Ling Ma reflect on art, literature, and the experienceof living your life during a globalcrisis.",
...
},
{
"id": "29a87bc4-6fda-5aec-be22-bb723914cb13",
"api_model": "event-occurrences",
"api_link": "https://api.artic.edu/api/v1/event-occurrences/29a87bc4-6fda-5aec-be22-bb723914cb13",
"title": "Virtual Talk: Chicago Stories",
"event_id": 5141,
"short_description": "Educators Corinne Rose and Nancy Chen focus on the artwork of the Ukrainian-born artist Todros Geller as a lens to explore immigrant experience in 1920s Chicago.",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /event-occurrences/search
Search event-occurrences data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/event-occurrences/search
{
"preference": null,
"pagination": {
"total": 35,
"limit": 10,
"offset": 0,
"total_pages": 4,
"current_page": 1
},
"data": [
{
"_score": 1.2260857,
"api_model": "event-occurrences",
"api_link": "https://api.artic.edu/api/v1/event-occurrences/019afb63-9f6f-536c-91b1-83a55811699a",
"id": "019afb63-9f6f-536c-91b1-83a55811699a",
"title": "Jam 2021: Research",
"timestamp": "2021-03-22T03:51:33-05:00"
},
{
"_score": 1.2260857,
"api_model": "event-occurrences",
"api_link": "https://api.artic.edu/api/v1/event-occurrences/06baf7b8-ffbc-55bf-b4fe-064c943e24a9",
"id": "06baf7b8-ffbc-55bf-b4fe-064c943e24a9",
"title": "Jam 2021: \u201cHandle with Care\u201d",
"timestamp": "2021-03-22T03:51:33-05:00"
},
{
"_score": 1.2260857,
"api_model": "event-occurrences",
"api_link": "https://api.artic.edu/api/v1/event-occurrences/0ce64fcf-f529-560d-8b4c-55a246b48065",
"id": "0ce64fcf-f529-560d-8b4c-55a246b48065",
"title": "Luminary Tour: Hartwell Memorial Window",
"timestamp": "2021-03-22T03:51:33-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /event-occurrences/{id}
A single event-occurrence by the given identifier.
Example request: https://api.artic.edu/api/v1/event-occurrences/06227504-e4c5-543f-90a8-2acc0c203788
{
"data": {
"id": "06227504-e4c5-543f-90a8-2acc0c203788",
"api_model": "event-occurrences",
"api_link": "https://api.artic.edu/api/v1/event-occurrences/06227504-e4c5-543f-90a8-2acc0c203788",
"title": "Virtual Member Lecture: Cosmoscapes\u2014Ink Paintings by Tai Xiangzhou",
"event_id": 5117,
"short_description": "Curator of Chinese art Colin Mackenzie discusses the revelatory works of Tai Xiangzhou, followed by a conversation betweenTao Wang,Pritzker Chair of the Arts of Asia and curator of Chinese art,and the artist.",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Event Programs
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /event-programs
A list of all event-programs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/event-programs?limit=2
{
"pagination": {
"total": 70,
"limit": 2,
"offset": 0,
"total_pages": 35,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/event-programs?page=2&limit=2"
},
"data": [
{
"id": 10,
"api_model": "event-programs",
"api_link": "https://api.artic.edu/api/v1/event-programs/10",
"title": "Intersections",
"is_affiliate_group": false,
"is_event_host": false,
...
},
{
"id": 9,
"api_model": "event-programs",
"api_link": "https://api.artic.edu/api/v1/event-programs/9",
"title": "Modern Wing Highlights",
"is_affiliate_group": false,
"is_event_host": false,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /event-programs/search
Search event-programs data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/event-programs/search
{
"preference": null,
"pagination": {
"total": 70,
"limit": 10,
"offset": 0,
"total_pages": 7,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "event-programs",
"api_link": "https://api.artic.edu/api/v1/event-programs/1",
"id": 1,
"title": "Artist\u2019s Studio",
"timestamp": "2021-03-22T03:51:34-05:00"
},
{
"_score": 1,
"api_model": "event-programs",
"api_link": "https://api.artic.edu/api/v1/event-programs/2",
"id": 2,
"title": "Family Festivals",
"timestamp": "2021-03-22T03:51:34-05:00"
},
{
"_score": 1,
"api_model": "event-programs",
"api_link": "https://api.artic.edu/api/v1/event-programs/3",
"id": 3,
"title": "Picture This",
"timestamp": "2021-03-22T03:51:34-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /event-programs/{id}
A single event-program by the given identifier.
Example request: https://api.artic.edu/api/v1/event-programs/1
{
"data": {
"id": 1,
"api_model": "event-programs",
"api_link": "https://api.artic.edu/api/v1/event-programs/1",
"title": "Artist\u2019s Studio",
"is_affiliate_group": false,
"is_event_host": false,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Articles
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /articles
A list of all articles sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/articles?limit=2
{
"pagination": {
"total": 301,
"limit": 2,
"offset": 0,
"total_pages": 151,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/articles?page=2&limit=2"
},
"data": [
{
"id": 889,
"api_model": "articles",
"api_link": "https://api.artic.edu/api/v1/articles/889",
"title": "when-eileen-agar-made-a-magritte-her-own",
"is_published": false,
"date": "2020-12-15T00:00:00-06:00",
...
},
{
"id": 705,
"api_model": "articles",
"api_link": "https://api.artic.edu/api/v1/articles/705",
"title": "hidden-materials-in-john-singer-sargents-watercolors",
"is_published": true,
"date": "2018-08-01T00:00:00-05:00",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /articles/search
Search articles data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/articles/search
{
"preference": null,
"pagination": {
"total": 312,
"limit": 10,
"offset": 0,
"total_pages": 32,
"current_page": 1
},
"data": [
{
"_score": 4.062318,
"api_model": "articles",
"api_link": "https://api.artic.edu/api/v1/articles/14",
"id": 14,
"title": "secrets-of-the-modern-wing",
"timestamp": "2021-03-22T03:51:34-05:00"
},
{
"_score": 4.062318,
"api_model": "articles",
"api_link": "https://api.artic.edu/api/v1/articles/18",
"id": 18,
"title": "your-move",
"timestamp": "2021-03-22T03:51:34-05:00"
},
{
"_score": 4.062318,
"api_model": "articles",
"api_link": "https://api.artic.edu/api/v1/articles/26",
"id": 26,
"title": "secrets-of-the-modern-wing-take-two",
"timestamp": "2021-03-22T03:51:34-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /articles/{id}
A single article by the given identifier.
Example request: https://api.artic.edu/api/v1/articles/14
{
"data": {
"id": 14,
"api_model": "articles",
"api_link": "https://api.artic.edu/api/v1/articles/14",
"title": "secrets-of-the-modern-wing",
"is_published": true,
"date": "2009-11-03T00:00:00-06:00",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Selections
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /selections
A list of all selections sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/selections?limit=2
{
"pagination": {
"total": 23,
"limit": 2,
"offset": 0,
"total_pages": 12,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/selections?page=2&limit=2"
},
"data": [
{
"id": 8,
"api_model": "selections",
"api_link": "https://api.artic.edu/api/v1/selections/8",
"title": "holidays-at-the-art-institute-201920",
"published": false,
"short_copy": "<p>Make the Art Institute your home for the holidays this season.</p>",
...
},
{
"id": 6,
"api_model": "selections",
"api_link": "https://api.artic.edu/api/v1/selections/6",
"title": "american-art",
"published": true,
"short_copy": "<p>The Art Institute boasts an outstanding collection of American Art\u2014fitting for a classic American city. Find some of the icons below.</p>",
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /selections/search
Search selections data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/selections/search
{
"preference": null,
"pagination": {
"total": 25,
"limit": 10,
"offset": 0,
"total_pages": 3,
"current_page": 1
},
"data": [
{
"_score": 4.3071003,
"api_model": "selections",
"api_link": "https://api.artic.edu/api/v1/selections/3",
"id": 3,
"title": "what-to-see-in-an-hour",
"timestamp": "2021-03-22T03:51:35-05:00"
},
{
"_score": 4.3071003,
"api_model": "selections",
"api_link": "https://api.artic.edu/api/v1/selections/4",
"id": 4,
"title": "new-on-view",
"timestamp": "2021-03-22T03:51:35-05:00"
},
{
"_score": 4.3071003,
"api_model": "selections",
"api_link": "https://api.artic.edu/api/v1/selections/5",
"id": 5,
"title": "impressionism",
"timestamp": "2021-03-22T03:51:35-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /selections/{id}
A single selection by the given identifier.
Example request: https://api.artic.edu/api/v1/selections/3
{
"data": {
"id": 3,
"api_model": "selections",
"api_link": "https://api.artic.edu/api/v1/selections/3",
"title": "what-to-see-in-an-hour",
"published": true,
"short_copy": "Short on time? Never fear, you can still see some of the most iconic and beloved works in the Art Institute\u2019s collection on this quick spin through the galleries. Ready, set\u2014art!",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Web Artists
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /web-artists
A list of all web-artists sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/web-artists?limit=2
{
"pagination": {
"total": 139,
"limit": 2,
"offset": 0,
"total_pages": 70,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/web-artists?page=2&limit=2"
},
"data": [
{
"id": 3,
"api_model": "web-artists",
"api_link": "https://api.artic.edu/api/v1/web-artists/3",
"title": "Neue Galerie New York",
"has_also_known_as": null,
"intro_copy": null,
...
},
{
"id": 2,
"api_model": "web-artists",
"api_link": "https://api.artic.edu/api/v1/web-artists/2",
"title": "Don A. DuBroff",
"has_also_known_as": null,
"intro_copy": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /web-artists/search
Search web-artists data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/web-artists/search
{
"preference": null,
"pagination": {
"total": 165,
"limit": 10,
"offset": 0,
"total_pages": 17,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "web-artists",
"api_link": "https://api.artic.edu/api/v1/web-artists/1",
"id": 1,
"title": "Winslow Homer",
"timestamp": "2021-03-22T03:51:35-05:00"
},
{
"_score": 1,
"api_model": "web-artists",
"api_link": "https://api.artic.edu/api/v1/web-artists/2",
"id": 2,
"title": "Don A. DuBroff",
"timestamp": "2021-03-22T03:51:35-05:00"
},
{
"_score": 1,
"api_model": "web-artists",
"api_link": "https://api.artic.edu/api/v1/web-artists/3",
"id": 3,
"title": "Neue Galerie New York",
"timestamp": "2021-03-22T03:51:35-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /web-artists/{id}
A single web-artist by the given identifier.
Example request: https://api.artic.edu/api/v1/web-artists/1
{
"data": {
"id": 1,
"api_model": "web-artists",
"api_link": "https://api.artic.edu/api/v1/web-artists/1",
"title": "Winslow Homer",
"has_also_known_as": null,
"intro_copy": "<p>Winslow Homer, one of the most influential American painters of the nineteenth century, is known for his dynamic depictions of the power and beauty of nature and reflections on humanity\u2019s struggle with the sea. A keen observer of the world around him, Homer likewise experimented with color, form, and composition, pushing his landscapes and genre pictures in modern directions. Raised in Massachusetts, he apprenticed in a lithography shop in Boston in the mid-1850s and soon secured work as a freelance illustrator. Relocating to New York, he undertook assignments for <em>Harper\u2019s Weekly</em><span>, among other journals, and enrolled in drawing classes at the National Academy of Design. </span></p><p>During the Civil War, <em>Harper\u2019s Weekly</em><span> sent</span><em><span> </span></em><span>Homer to the front, where he made drawings of </span><a href=\"https://www.artic.edu/artworks/158367/the-war-for-the-union-1862-a-cavalry-charge\" target=\"_blank\"><span>Union battlefields</span></a><span>, camps, and military hospitals that appeared as wood engravings in the widely circulated publication. Homer also took up painting during his time as an artist-correspondent. After the war, he focused on oil painting, working in New York and also traveling to France in 1866\u201367. Over the following decade, Homer painted </span><a href=\"https://www.artic.edu/artworks/44018/croquet-scene\" target=\"_blank\"><span>scenes of leisure</span></a><span> set in nature, such as </span><a href=\"https://www.artic.edu/artworks/75957/mount-washington\" target=\"_blank\"><span>the White Mountains</span></a><span> in New Hampshire and the Adirondacks in upstate New York. He also spent his summers visiting </span><a href=\"https://www.artic.edu/artworks/16800/boy-in-boat-gloucester\" target=\"_blank\"><span>New England fishing villages</span></a><span>, discovering new subjects that had a profound effect on his career. </span></p><p>In 1881, he spent more than a year in the small fishing village of Cullercoats, England. This extended stay in the seaside community catalyzed a new, enduring interest in humankind\u2019s age-old contest with nature, rendered in larger-scale compositions with more monumental figures and forms. In the summer of 1883 Homer moved to the coastal village of Prouts Neck, Maine, which remained his home for the rest of his life. There, he observed the shoreline in various weather conditions and seasons, creating his great seascapes, such as the iconic work <a href=\"https://www.artic.edu/artworks/25865/the-herring-net\" target=\"_blank\"><em>The Herring Net</em></a><span>. Amid the remote and dramatic landscape, he depicted views void of human life, focusing instead on an emotional response to nature, as in </span><a href=\"https://www.artic.edu/artworks/8971/coast-of-maine\" target=\"_blank\"><em><span>Coast of Maine</span></em></a><span>. </span></p><p>Late in his career, during visits to the Bahamas, Bermuda, Cuba, and Florida, Homer applied his sophisticated understanding of color and light to a new set of atmospheric conditions, most spectacularly in his watercolors, such as <a href=\"https://www.artic.edu/artworks/16776/after-the-hurricane-bahamas\" target=\"_blank\"><em>After the Hurricane, Bahamas</em></a><span>.</span></p><p>The Art Institute\u2019s collection of works by Winslow Homer spans his career. The artist\u2019s works on paper were featured in the 2008 exhibition <a href=\"https://archive.artic.edu/homer_exhb/overview/\" target=\"_blank\"><em>Watercolors by Winslow Homer: The Color of Light</em></a><em>.</em></p>",
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Static Pages
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /static-pages
A list of all static-pages sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/static-pages?limit=2
{
"pagination": {
"total": 11,
"limit": 2,
"offset": 0,
"total_pages": 6,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/static-pages?page=2&limit=2"
},
"data": [
{
"id": 11,
"api_model": "static-pages",
"api_link": "https://api.artic.edu/api/v1/static-pages/11",
"title": "Articles",
"web_url": "/articles",
"is_published": true,
...
},
{
"id": 2,
"api_model": "static-pages",
"api_link": "https://api.artic.edu/api/v1/static-pages/2",
"title": "Events",
"web_url": "/events",
"is_published": true,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /static-pages/search
Search static-pages data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/static-pages/search
{
"preference": null,
"pagination": {
"total": 11,
"limit": 10,
"offset": 0,
"total_pages": 2,
"current_page": 1
},
"data": [
{
"_score": 4.0851192,
"api_model": "static-pages",
"api_link": "https://api.artic.edu/api/v1/static-pages/1",
"id": 1,
"title": "Visit",
"timestamp": "2021-03-22T14:15:05-05:00"
},
{
"_score": 4.0851192,
"api_model": "static-pages",
"api_link": "https://api.artic.edu/api/v1/static-pages/2",
"id": 2,
"title": "Events",
"timestamp": "2021-03-22T14:15:05-05:00"
},
{
"_score": 4.0851192,
"api_model": "static-pages",
"api_link": "https://api.artic.edu/api/v1/static-pages/3",
"id": 3,
"title": "Exhibitions",
"timestamp": "2021-03-22T14:15:05-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /static-pages/{id}
A single static-page by the given identifier.
Example request: https://api.artic.edu/api/v1/static-pages/1
{
"data": {
"id": 1,
"api_model": "static-pages",
"api_link": "https://api.artic.edu/api/v1/static-pages/1",
"title": "Visit",
"web_url": "/visit",
"is_published": true,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Generic Pages
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /generic-pages
A list of all generic-pages sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/generic-pages?limit=2
{
"pagination": {
"total": 255,
"limit": 2,
"offset": 0,
"total_pages": 128,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/generic-pages?page=2&limit=2"
},
"data": [
{
"id": 468,
"api_model": "generic-pages",
"api_link": "https://api.artic.edu/api/v1/generic-pages/468",
"title": "test",
"is_published": false,
"type": null,
...
},
{
"id": 204,
"api_model": "generic-pages",
"api_link": "https://api.artic.edu/api/v1/generic-pages/204",
"title": "Databases for Auction Research",
"is_published": false,
"type": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /generic-pages/search
Search generic-pages data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/generic-pages/search
{
"preference": null,
"pagination": {
"total": 259,
"limit": 10,
"offset": 0,
"total_pages": 26,
"current_page": 1
},
"data": [
{
"_score": 4.155737,
"api_model": "generic-pages",
"api_link": "https://api.artic.edu/api/v1/generic-pages/2",
"id": 2,
"title": "Free Admission Opportunities",
"timestamp": "2021-03-22T03:51:36-05:00"
},
{
"_score": 4.155737,
"api_model": "generic-pages",
"api_link": "https://api.artic.edu/api/v1/generic-pages/4",
"id": 4,
"title": "Directions & Parking",
"timestamp": "2021-03-22T03:51:36-05:00"
},
{
"_score": 4.155737,
"api_model": "generic-pages",
"api_link": "https://api.artic.edu/api/v1/generic-pages/6",
"id": 6,
"title": "Dining",
"timestamp": "2021-03-22T03:51:36-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /generic-pages/{id}
A single generic-page by the given identifier.
Example request: https://api.artic.edu/api/v1/generic-pages/2
{
"data": {
"id": 2,
"api_model": "generic-pages",
"api_link": "https://api.artic.edu/api/v1/generic-pages/2",
"title": "Free Admission Opportunities",
"is_published": true,
"type": null,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Press Releases
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /press-releases
A list of all press-releases sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/press-releases?limit=2
{
"pagination": {
"total": 281,
"limit": 2,
"offset": 0,
"total_pages": 141,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/press-releases?page=2&limit=2"
},
"data": [
{
"id": 60,
"api_model": "press-releases",
"api_link": "https://api.artic.edu/api/v1/press-releases/60",
"title": "Press Releases from 1998",
"is_published": true,
"type": null,
...
},
{
"id": 50,
"api_model": "press-releases",
"api_link": "https://api.artic.edu/api/v1/press-releases/50",
"title": "Press Releases from 1988",
"is_published": true,
"type": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /press-releases/search
Search press-releases data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/press-releases/search
{
"preference": null,
"pagination": {
"total": 284,
"limit": 10,
"offset": 0,
"total_pages": 29,
"current_page": 1
},
"data": [
{
"_score": 4.0141125,
"api_model": "press-releases",
"api_link": "https://api.artic.edu/api/v1/press-releases/1",
"id": 1,
"title": "Press Releases from 1939",
"timestamp": "2021-03-22T03:51:36-05:00"
},
{
"_score": 4.0141125,
"api_model": "press-releases",
"api_link": "https://api.artic.edu/api/v1/press-releases/2",
"id": 2,
"title": "Press Releases from 1940",
"timestamp": "2021-03-22T03:51:36-05:00"
},
{
"_score": 4.0141125,
"api_model": "press-releases",
"api_link": "https://api.artic.edu/api/v1/press-releases/3",
"id": 3,
"title": "Press Releases from 1941",
"timestamp": "2021-03-22T03:51:36-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /press-releases/{id}
A single press-release by the given identifier.
Example request: https://api.artic.edu/api/v1/press-releases/1
{
"data": {
"id": 1,
"api_model": "press-releases",
"api_link": "https://api.artic.edu/api/v1/press-releases/1",
"title": "Press Releases from 1939",
"is_published": true,
"type": null,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Educator Resources
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /educator-resources
A list of all educator-resources sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/educator-resources?limit=2
{
"pagination": {
"total": 110,
"limit": 2,
"offset": 0,
"total_pages": 55,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/educator-resources?page=2&limit=2"
},
"data": [
{
"id": 2,
"api_model": "educator-resources",
"api_link": "https://api.artic.edu/api/v1/educator-resources/2",
"title": "Test Resource",
"is_published": false,
"type": null,
...
},
{
"id": 3,
"api_model": "educator-resources",
"api_link": "https://api.artic.edu/api/v1/educator-resources/3",
"title": "Activity: Arrival of the Normandy Train, Gare Saint-Lazare",
"is_published": false,
"type": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /educator-resources/search
Search educator-resources data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/educator-resources/search
{
"preference": null,
"pagination": {
"total": 120,
"limit": 10,
"offset": 0,
"total_pages": 12,
"current_page": 1
},
"data": [
{
"_score": 4.6027293,
"api_model": "educator-resources",
"api_link": "https://api.artic.edu/api/v1/educator-resources/7",
"id": 7,
"title": "Thematic Curriculum: Art + Science",
"timestamp": "2021-03-22T03:51:37-05:00"
},
{
"_score": 4.6027293,
"api_model": "educator-resources",
"api_link": "https://api.artic.edu/api/v1/educator-resources/12",
"id": 12,
"title": "Educator Resource Packet: A Boy in Front of the Loews 125th Street Movie Theater, from the series Harlem, U.S.A",
"timestamp": "2021-03-22T03:51:37-05:00"
},
{
"_score": 4.6027293,
"api_model": "educator-resources",
"api_link": "https://api.artic.edu/api/v1/educator-resources/13",
"id": 13,
"title": "Educator Resource Packet: America Windows by Marc Chagall",
"timestamp": "2021-03-22T03:51:37-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /educator-resources/{id}
A single educator-resource by the given identifier.
Example request: https://api.artic.edu/api/v1/educator-resources/7
{
"data": {
"id": 7,
"api_model": "educator-resources",
"api_link": "https://api.artic.edu/api/v1/educator-resources/7",
"title": "Thematic Curriculum: Art + Science",
"is_published": true,
"type": null,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Digital Catalogs
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /digital-catalogs
A list of all digital-catalogs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/digital-catalogs?limit=2
{
"pagination": {
"total": 15,
"limit": 2,
"offset": 0,
"total_pages": 8,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/digital-catalogs?page=2&limit=2"
},
"data": [
{
"id": 2,
"api_model": "digital-catalogs",
"api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
"title": "American Silver",
"is_published": true,
"type": null,
...
},
{
"id": 5,
"api_model": "digital-catalogs",
"api_link": "https://api.artic.edu/api/v1/digital-catalogs/5",
"title": "Roman Art at the Art Institute of Chicago",
"is_published": true,
"type": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /digital-catalogs/search
Search digital-catalogs data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/digital-catalogs/search
{
"preference": null,
"pagination": {
"total": 17,
"limit": 10,
"offset": 0,
"total_pages": 2,
"current_page": 1
},
"data": [
{
"_score": 4.115182,
"api_model": "digital-catalogs",
"api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
"id": 2,
"title": "American Silver",
"timestamp": "2021-03-22T03:51:38-05:00"
},
{
"_score": 4.115182,
"api_model": "digital-catalogs",
"api_link": "https://api.artic.edu/api/v1/digital-catalogs/3",
"id": 3,
"title": "Modern Series: Go",
"timestamp": "2021-03-22T03:51:38-05:00"
},
{
"_score": 4.115182,
"api_model": "digital-catalogs",
"api_link": "https://api.artic.edu/api/v1/digital-catalogs/4",
"id": 4,
"title": "Manet Paintings and Works on Paper at the Art Institute of Chicago",
"timestamp": "2021-03-22T03:51:38-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /digital-catalogs/{id}
A single digital-catalog by the given identifier.
Example request: https://api.artic.edu/api/v1/digital-catalogs/2
{
"data": {
"id": 2,
"api_model": "digital-catalogs",
"api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
"title": "American Silver",
"is_published": true,
"type": null,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Printed Catalogs
The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.
# GET /printed-catalogs
A list of all printed-catalogs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.
# Available parameters:
ids
- A comma-separated list of resource ids to retrievelimit
- The number of resources to return per pagepage
- The page of resources to retrievefields
- A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/printed-catalogs?limit=2
{
"pagination": {
"total": 183,
"limit": 2,
"offset": 0,
"total_pages": 92,
"current_page": 1,
"next_url": "https://api.artic.edu/api/v1/printed-catalogs?page=2&limit=2"
},
"data": [
{
"id": 41,
"api_model": "printed-catalogs",
"api_link": "https://api.artic.edu/api/v1/printed-catalogs/41",
"title": "2001: Building for Space Travel",
"is_published": true,
"type": null,
...
},
{
"id": 39,
"api_model": "printed-catalogs",
"api_link": "https://api.artic.edu/api/v1/printed-catalogs/39",
"title": "1945: Creativity and Crisis, Chicago Architecture and Design of the World War II Era",
"is_published": true,
"type": null,
...
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# GET /printed-catalogs/search
Search printed-catalogs data in the aggregator.
# Available parameters:
q
- Your search queryquery
- For complex queries, you can pass Elasticsearch domain syntax queries heresort
- Used in conjunction withquery
from
- Starting point of results. Pagination via Elasticsearch conventionssize
- Number of results to return. Pagination via Elasticsearch conventionsfacets
- A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/printed-catalogs/search
{
"preference": null,
"pagination": {
"total": 184,
"limit": 10,
"offset": 0,
"total_pages": 19,
"current_page": 1
},
"data": [
{
"_score": 1,
"api_model": "printed-catalogs",
"api_link": "https://api.artic.edu/api/v1/printed-catalogs/4",
"id": 4,
"title": "The Art Institute of Chicago: The Essential Guide",
"timestamp": "2021-03-22T03:51:38-05:00"
},
{
"_score": 1,
"api_model": "printed-catalogs",
"api_link": "https://api.artic.edu/api/v1/printed-catalogs/5",
"id": 5,
"title": "Roy Lichtenstein: A Retrospective",
"timestamp": "2021-03-22T03:51:38-05:00"
},
{
"_score": 1,
"api_model": "printed-catalogs",
"api_link": "https://api.artic.edu/api/v1/printed-catalogs/6",
"id": 6,
"title": "Dawoud Bey: Harlem, U.S.A.",
"timestamp": "2021-03-22T03:51:38-05:00"
}
],
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.0"
}
}
# GET /printed-catalogs/{id}
A single printed-catalog by the given identifier.
Example request: https://api.artic.edu/api/v1/printed-catalogs/4
{
"data": {
"id": 4,
"api_model": "printed-catalogs",
"api_link": "https://api.artic.edu/api/v1/printed-catalogs/4",
"title": "The Art Institute of Chicago: The Essential Guide",
"is_published": true,
"type": null,
...
},
"info": {
"license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
"license_links": [
"https://www.artic.edu/terms"
],
"version": "1.1"
},
"config": {
"iiif_url": "https://www.artic.edu/iiif/2",
"website_url": "https://www.artic.edu"
}
}
# Fields
# Collections
# Artworks
Represents a work of art in our collections. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourceis_boosted
boolean - Whether this document should be boosted in searchtitle
string - The name of this resourcealt_titles
array - Alternate names for this workthumbnail
array - Metadata about the image referenced byimage_id
. Currently, all thumbnails are IIIF images. You must build your own image URLs using IIIF Image API conventions. See our API documentation for more details.main_reference_number
string - Unique identifier assigned to the artwork upon acquisitionhas_not_been_viewed_much
boolean - Whether the artwork hasn't been visited on our website very muchboost_rank
number - Manual indication of what rank this artwork should take in search results. Noncontiguous.date_start
number - The year of the period of time associated with the creation of this workdate_end
number - The year of the period of time associated with the creation of this workdate_display
string - Readable, free-text description of the period of time associated with the creation of this work. This might include date terms like Dynasty, Era etc. Written by curators and editors in house style, and is the preferred field for display on websites and apps.date_qualifier_title
string - Readable, text qualifer to the dates provided for this record.date_qualifier_id
integer - Unique identifier of the qualifer to the dates provided for this record.artist_display
string - Readable description of the creator of this work. Includes artist names, nationality and lifespan datesplace_of_origin
string - The location where the creation, design, or production of the work took place, or the original location of the workdimensions
string - The size, shape, scale, and dimensions of the work. May include multiple dimensions like overall, frame, or dimension for each section of a work. Free-form text formatted in a house style.medium_display
string - The substances or materials used in the creation of a workinscriptions
string - A description of distinguishing or identifying physical markings that are on the workcredit_line
string - Brief statement indicating how the work came into the collectionpublication_history
string - Bibliographic list of all the places this work has been publishedexhibition_history
string - List of all the places this work has been exhibitedprovenance_text
string - Ownership/collecting history of the work. May include names of owners, dates, and possibly methods of transfer of ownership. Free-form text formatted in a house style.publishing_verification_level
string - Indicator of how much metadata on the work in published. Web Basic is the least amount, Web Everything is the greatest.internal_department_id
number - An internal department id we use for analytics. Does not correspond to departments on the website.fiscal_year
number - The fiscal year in which the work was acquired.fiscal_year_deaccession
number - The fiscal year in which the work was deaccessioned.is_public_domain
boolean - Whether the work is in the public domain, meaning it was created before copyrights existed or has left the copyright termis_zoomable
boolean - Whether images of the work are allowed to be displayed in a zoomable interface.max_zoom_window_size
number - The maximum size of the window the image is allowed to be viewed in, in pixels.copyright_notice
string - Statement notifying how the work is protected by copyright. Applies to the work itself, not image or other related assets.has_multimedia_resources
boolean - Whether this artwork has any associated microsites, digital publications, or documents tagged as multimediahas_educational_resources
boolean - Whether this artwork has any documents tagged as educationalcolorfulness
float - Unbounded positive float representing an abstract measure of colorfulness.color
object - Dominant color of this artwork in HSLlatitude
number - Latitude coordinate of the location of this work in our gallerieslongitude
number - Longitude coordinate of the location of this work in our gallerieslatlon
string - Latitude and longitude coordinates of the location of this work in our galleriesis_on_view
boolean - Whether the work is on displayon_loan_display
string - If an artwork is on loan, this contains details about the loangallery_title
string - The location of this work in our museumgallery_id
number - Unique identifier of the location of this work in our museumartwork_type_title
string - The kind of object or work (e.g. Painting, Sculpture, Book)artwork_type_id
number - Unique identifier of the kind of object or workdepartment_title
string - Name of the curatorial department that this work belongs todepartment_id
number - Unique identifier of the curatorial department that this work belongs toartist_id
integer - Unique identifier of the preferred artist/culture associated with this workartist_title
string - Name of the preferred artist/culture associated with this workalt_artist_ids
array - Unique identifiers of the non-preferred artists/cultures associated with this workartist_ids
integer - Unique identifier of all artist/cultures associated with this workartist_titles
array - Names of all artist/cultures associated with this workcategory_ids
array - Unique identifiers of the categories this work is a part ofcategory_titles
array - Names of the categories this artwork is a part ofartwork_catalogue_ids
array - This list represents all the catalogues this work is included in. This isn't an exhaustive list of publications where the work has been mentioned. For that, seepublication_history
.term_titles
array - The names of the taxonomy tags for this workstyle_id
string - Unique identifier of the preferred style term for this workstyle_title
string - The name of the preferred style term for this workalt_style_ids
array - Unique identifiers of all other non-preferred style terms for this workstyle_ids
array - Unique identifiers of all style terms for this workstyle_titles
array - The names of all style terms related to this artworkclassification_id
string - Unique identifier of the preferred classification term for this workclassification_title
string - The name of the preferred classification term for this workalt_classification_ids
array - Unique identifiers of all other non-preferred classification terms for this workclassification_ids
array - Unique identifiers of all classification terms for this workclassification_titles
array - The names of all classification terms related to this artworksubject_id
string - Unique identifier of the preferred subject term for this workalt_subject_ids
array - Unique identifiers of all other non-preferred subject terms for this worksubject_ids
array - Unique identifiers of all subject terms for this worksubject_titles
array - The names of all subject terms related to this artworkmaterial_id
string - Unique identifier of the preferred material term for this workalt_material_ids
array - Unique identifiers of all other non-preferred material terms for this workmaterial_ids
array - Unique identifiers of all material terms for this workmaterial_titles
array - The names of all material terms related to this artworktechnique_id
string - Unique identifier of the preferred technique term for this workalt_technique_ids
array - Unique identifiers of all other non-preferred technique terms for this worktechnique_ids
array - Unique identifiers of all technique terms for this worktechnique_titles
array - The names of all technique terms related to this artworktheme_titles
array - The names of all thematic publish categories related to this artworkimage_id
uuid - Unique identifier of the preferred image to use to represent this workalt_image_ids
array - Unique identifiers of all non-preferred images of this work.document_ids
array - Unique identifiers of assets that serve as documentation for this artworksound_ids
uuid - Unique identifiers of the audio about this workvideo_ids
uuid - Unique identifiers of the videos about this worktext_ids
uuid - Unique identifiers of the texts about this worksection_ids
array - Unique identifiers of the digital publication chapters this work in included insection_titles
array - Names of the digital publication chapters this work is included insite_ids
array - Unique identifiers of the microsites this work is a part ofsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Agents
Represents a person or organization. In the API, this includes artists. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesort_title
string - Sortable name for this agent, typically with last name first.alt_titles
array - Alternate names for this agentbirth_date
number - The year this agent was bornbirth_place
string - Name of the place this agent was borndeath_date
number - The year this agent dieddeath_place
string - Name of the place this agent dieddescription
string - A biographical description of the agentis_licensing_restricted
boolean - Whether the use of the images of works by this artist are restricted by licensingis_artist
boolean - Whether the agent is an artist. Solely based on whether the agent is listed as an artist for an artwork record.agent_type_title
string - Name of the type of agent, e.g. individual, fund, school, organization, etc.agent_type_id
number - Unique identifier of the type of agent, e.g. individual, fund, school, organization, etc.artwork_ids
array - Unique identifiers of the works this artist created.site_ids
array - Unique identifiers of the microsites this exhibition is a part ofsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Places
A room or hall that works of art are displayed in. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - Type always takes one of the following values: AIC Gallery, AIC Storage, No locationsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Galleries
A room or hall that works of art are displayed in. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - Type always takes one of the following values: AIC Gallery, AIC Storage, No locationis_closed
boolean - Whether the gallery is currently closednumber
string - The gallery's room number. For "Gallery 100A", this would be "100A".floor
string - The level the gallery is on, e.g., 1, 2, 3, or LLlatitude
number - Latitude coordinate of the center of the roomlongitude
number - Longitude coordinate of the center of the roomlatlon
string - Latitude and longitude coordinates of the center of the roomsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Exhibitions
An organized presentation and display of a selection of artworks. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceis_featured
boolean - Is this exhibition currently featured on our website?description
string - Explanation of what this exhibition isshort_description
string - Brief explanation of what this exhibition isweb_url
string - URL to this exhibition on our websiteimage_url
string - URL to the hero image from the websitetype
string - The type of exhibition. In particular this notes whether the exhibition was only displayed at the Art Institute or whether it traveled to other venues.status
string - Whether the exhibition is open or closedaic_start_at
ISO 8601 date and time - Date the exhibition opened at the Art Institute of Chicagoaic_end_at
ISO 8601 date and time - Date the exhibition closed at the Art Institute of Chicagodate_display
string - A human-friendly string describing when this exhibition was opendepartment_display
string - The name of the department that primarily organized the exhibitiongallery_id
number - Unique identifier of the gallery that mainly housed the exhibitiongallery_title
string - The name of the gallery that mainly housed the exhibitionartwork_ids
array - Unique identifiers of the artworks that were part of the exhibitionartwork_titles
array - Names of the artworks that were part of the exhibitionartist_ids
array - Unique identifiers of the artist agent records representing who was shown in the exhibitionsite_ids
array - Unique identifiers of the microsites this exhibition is a part ofimage_id
uuid - Unique identifier of the preferred image to use to represent this exhibitionalt_image_ids
array - Unique identifiers of all non-preferred images of this exhibition.document_ids
array - Unique identifiers of assets that serve as documentation for this exhibitionsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Agent Types
A kind of agent, e.g. Individual, Couple, School, Estate, Culture. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Agent Roles
A qualifier for the relationship an agent may have to an artwork. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Agent Place Qualifiers
A qualifier for the relationship a place may have to an agent. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Artwork Types
A kind of object or work, e.g., Painting, Sculpture, Book, etc. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Artwork Place Qualifiers
A qualifier for the relationship a place may have to an artwork. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Artwork Date Qualifiers
A kind of date on at artwork, e.g., Made, Reconstructed, Published, etc. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Catalogues
Represents a catalogue raisonne. A catalogue raisonné is a comprehensive, annotated listing of all the known artworks by an artist. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Category Terms
Tag-like classifications of artworks and other resources. For a description of all the endpoints available for this resource, see here.
id
keyword - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcesubtype
string - Takes one of the following values: classification, material, technique, style, subject, department, themeparent_id
string - Unique identifier of this category's parentsuggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Images
A pictorial representation of a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.
id
keyword - Unique identifier of this resource. Taken from the source system.lake_guid
uuid - Unique UUID of this resource in LAKE, our DAMS.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - Type always takes one of the following values: image, sound, text, videodescription
string - Explanation of what this asset isalt_text
string - Alternative text for the asset to describe it to people with low or no visioncontent
string - Text of or URL to the contents of this assetis_multimedia_resource
boolean - Whether this resource is considered to be multimediais_educational_resource
boolean - Whether this resource is considered to be educationalis_teacher_resource
boolean - Whether this resource is considered to be educationalcredit_line
string - Asset-specific copyright informationcontent_e_tag
string - Arbitrary unique identifier that changes when the binary file gets updatedcontent_modified_at
ISO 8601 date and time - Date and time the associated binary file was updatediiif_url
url - IIIF URL of this imagewidth
number - Native width of the imageheight
number - Native height of the imagelqip
text - Low-quality image placeholder (LQIP). Currently a 5x5-constrained, base64-encoded GIF.colorfulness
float - Unbounded positive float representing an abstract measure of colorfulness.color
object - Dominant color of this image in HSLfingerprint
object - Image hashes: aHash, dHash, pHash, wHashartwork_ids
array - Unique identifiers of the artworks associated with this assetartwork_titles
array - Names of the artworks associated with this assetsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of datalast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Videos
A moving image representation of a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.
id
keyword - Unique identifier of this resource. Taken from the source system.lake_guid
uuid - Unique UUID of this resource in LAKE, our DAMS.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - Type always takes one of the following values: image, sound, text, videodescription
string - Explanation of what this asset isalt_text
string - Alternative text for the asset to describe it to people with low or no visioncontent
string - Text of or URL to the contents of this assetis_multimedia_resource
boolean - Whether this resource is considered to be multimediais_educational_resource
boolean - Whether this resource is considered to be educationalis_teacher_resource
boolean - Whether this resource is considered to be educationalcredit_line
string - Asset-specific copyright informationcontent_e_tag
string - Arbitrary unique identifier that changes when the binary file gets updatedcontent_modified_at
ISO 8601 date and time - Date and time the associated binary file was updatedartwork_ids
array - Unique identifiers of the artworks associated with this assetartwork_titles
array - Names of the artworks associated with this assetsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of datalast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Sounds
Audio that represents a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.
id
keyword - Unique identifier of this resource. Taken from the source system.lake_guid
uuid - Unique UUID of this resource in LAKE, our DAMS.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - Type always takes one of the following values: image, sound, text, videodescription
string - Explanation of what this asset isalt_text
string - Alternative text for the asset to describe it to people with low or no visioncontent
string - Text of or URL to the contents of this assetis_multimedia_resource
boolean - Whether this resource is considered to be multimediais_educational_resource
boolean - Whether this resource is considered to be educationalis_teacher_resource
boolean - Whether this resource is considered to be educationalcredit_line
string - Asset-specific copyright informationcontent_e_tag
string - Arbitrary unique identifier that changes when the binary file gets updatedcontent_modified_at
ISO 8601 date and time - Date and time the associated binary file was updatedartwork_ids
array - Unique identifiers of the artworks associated with this assetartwork_titles
array - Names of the artworks associated with this assetsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of datalast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Texts
Text that represents a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.
id
keyword - Unique identifier of this resource. Taken from the source system.lake_guid
uuid - Unique UUID of this resource in LAKE, our DAMS.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - Type always takes one of the following values: image, sound, text, videodescription
string - Explanation of what this asset isalt_text
string - Alternative text for the asset to describe it to people with low or no visioncontent
string - Text of or URL to the contents of this assetis_multimedia_resource
boolean - Whether this resource is considered to be multimediais_educational_resource
boolean - Whether this resource is considered to be educationalis_teacher_resource
boolean - Whether this resource is considered to be educationalcredit_line
string - Asset-specific copyright informationcontent_e_tag
string - Arbitrary unique identifier that changes when the binary file gets updatedcontent_modified_at
ISO 8601 date and time - Date and time the associated binary file was updatedartwork_ids
array - Unique identifiers of the artworks associated with this assetartwork_titles
array - Names of the artworks associated with this assetsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of datalast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Shop
# Products
An item available for purchase in the museum shop. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceexternal_sku
number - Numeric product identification code of a machine-readable barcode, when the customer sku differs from our internal oneimage_url
url - URL of an image for this productweb_url
url - URL of this product in the shopdescription
string - Explanation of what this product isprice_display
string - Explanation of what this product ismin_compare_at_price
number - Number indicating how much the least expensive variant of a product cost before a salemax_compare_at_price
number - Number indicating how much the most expensive variant of a product cost before a salemin_current_price
number - Number indicating how much the least expensive variant of a product costs right nowmax_current_price
number - Number indicating how much the most expensive variant of a product costs right nowartist_ids
array - Unique identifiers of the artists associated with this productartwork_ids
array - Unique identifiers of the artworks associated with this productexhibition_ids
array - Unique identifiers of the exhibitions associated with this productsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Mobile
# Tours
A collection of audio tour stops to form a tour. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceimage
url - The main image for the tourdescription
string - Explanation of what the tour isintro
string - Text introducing the tourweight
number - Number representing this tour's sort orderintro_link
url - Link to the audio file of the introductionintro_transcript
string - Transcript of the introduction audio to the tourartwork_titles
array - Names of the artworks featured in this tour's tour stopsartist_titles
array - Names of the artists of the artworks featured in this tour's tour stopssuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Mobile Sounds
The audio file for a stop on a tour. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - Name of this mobile audio file – derived from the artwork and tour titlesweb_url
url - URL to the audio filetranscript
string - Text transcription of the audio filesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Digital Scholarly Catalogs
# Publications
Represents an overall digital publication. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceweb_url
string - URL to the publicationsite
string - Which site in our multi-site Drupal installation owns this publicationalias
string - Used by Drupal in lieu of the id to generate pretty pathssection_ids
array - Unique identifiers of the sections of this publicationsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Sections
Represents a chapter of publication. For a description of all the endpoints available for this resource, see here.
id
long - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceweb_url
string - URL to the sectionaccession
string - An accession number parsed from the title or tombstonerevision
number - Version identifier as provided by Drupalsource_id
number - Drupal node id, unique only within the site of this publicationweight
number - Number representing this section's sort ordergeneric_page_id
number - Unique identifier of the page on the website that represents the publication this section belongs toartwork_id
number - Unique identifier of the artwork with which this section is associatedparent_id
number - Uniquer identifier of the parent sectionpublication_title
string - Name of the publication this section belongs topublication_id
number - Unique identifier of the publication this section belongs tocontent
string - Content of this section in plaintextsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Static Archive
# Sites
An archived static microsite. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcedescription
string - Explanation of what this site isweb_url
url - URL to this siteexhibition_ids
array - Unique identifier of the exhibitions this site is associated withexhibition_titles
array - Names of the exhibitions this site is associated withartist_ids
array - Unique identifiers of the artists this site is associated withartist_titles
array - Names of the artists this site is associated withartwork_ids
array - Unique identifiers of the artworks this site is associated withartwork_titles
array - Names of the artworks this site is associated withsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Website
# Closures
Closure on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcedate_start
ISO 8601 date and time - The date the closure beginsdate_end
ISO 8601 date and time - The date the closure endsclosure_copy
string - Description of the closuretype
number - Number indicating the type of closuresuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Web Exhibitions
An enhanced exhibition on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceexhibition_id
number - Identifier of the CITI exhibition this website exhibition is tied tois_featured
boolean - Is this exhibition currently featured on our website?header_copy
string - The text at the top of the exhibition pagelist_description
string - Short description to be used for exhibition listingsexhibition_message
string - Pricing or attendance informationsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Events
An event on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetitle_display
string - The name of this event formatted with HTML (optional)image_url
string - The URL of an image representing this pagehero_caption
string - Text displayed with the hero image on the eventshort_description
string - Brief description of the eventheader_description
string - Brief description of the event displayed below the titlelist_description
string - One-sentence description of the event displayed in listingsdescription
string - All copytext of the eventlocation
string - Where the event takes placeevent_type_id
number - Unique identifier indicating the preferred type of this eventalt_event_type_ids
array - Unique identifiers indicating the alternate types of this eventaudience_id
number - Unique identifier indicating the preferred audience for this eventalt_audience_ids
array - Unique identifiers indicating the alternate audiences for this eventprogram_ids
array - Unique identifiers indicating the programs this event is a part ofprogram_titles
array - Titles of the programs this event is a part ofis_ticketed
boolean - Whether a ticket is required to attend the eventrsvp_link
url - The URL to the sales site for this eventbuy_button_text
string - The text used on the ticket/registration buttonbuy_button_caption
string - Additional text below the ticket/registration buttonis_registration_required
boolean - Whether registration is required to attend the eventis_member_exclusive
boolean - Whether the event is exclusive to members of the museumis_sold_out
boolean - Whether the event is sold outis_free
boolean - Whether the event is freeis_admission_required
boolean - Whether admission to the museum is required to attend this eventis_after_hours
boolean - Whether the event is to be held after the museum closesis_virtual_event
boolean - Whether the event is being held virtuallystart_date
ISO 8601 date and time - The date the event beginsend_date
ISO 8601 date and time - The date the event endsstart_time
string - The time the event startsend_time
string - The time the event endsdate_display
string - A readable display of the event datesdoor_time
string - The time the doors open for this eventlayout_type
number - Number indicating the type of layout this event page usesslug
string - A string used in the URL for this evententrance
string - Which entrance to use for this eventjoin_url
string - URL to the membership signup page via this eventsurvey_url
string - URL to the survey associated with this eventevent_host_id
number - Unique identifier of the host (cf. event programs) that is presenting this eventevent_host_title
string - Unique identifier of the host (cf. event programs) that is presenting this eventsponsor_id
number - Unique identifier of the sponsor this website event is tied tosearch_tags
array - Editor-specified list of tags to aid in internal searchsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Event Occurrences
An occurrence of an event on the website For a description of all the endpoints available for this resource, see here.
id
keyword - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceevent_id
integer - Identifier of the master event of which this is an occurrenceshort_description
string - Brief description of the eventdescription
string - Description of the eventimage_url
string - The URL of an image representing this pageis_private
boolean - Whether the event is private. Private events should be omitted from listings.start_at
ISO 8601 date and time - The date the event occurrence beginsend_at
ISO 8601 date and time - The date the event occurrence endslocation
string - Where the event takes placebutton_url
url - The URL to the sales site or an RSVP link for this eventbutton_text
string - The text used on the ticket/registration buttonbutton_caption
string - Additional text below the ticket/registration buttonsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Event Programs
An event on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceis_affiliate_group
boolean - Whether this program represents an affiliate groupis_event_host
boolean - Whether this program represents an event hostsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Articles
Article on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcedate
ISO 8601 date and time - The date the article was publishedcopy
string - The text of the articlesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Selections
Selections are a grouping of artworks on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceshort_copy
string - A brief summary of what is contained in the selectioncopy
string - The text of the selection descriptionsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Web Artists
Article on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcehas_also_known_as
boolean - Whether the artist will display multiple namesintro_copy
string - Description of the artistagent_id
number - Unique identifier of the CITI agent records this artist representssuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Static Pages
Pages defined in the website code. For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourceweb_url
string - The URL to this page on our websitesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Generic Pages
A generic page on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - The type of page this record representsweb_url
string - The URL to this page on our websiteslug
string - A human-readable string used in the URLimage_url
string - The URL of an image representing this pagelisting_description
string - A brief description of the page used in listingsshort_description
string - A brief description of the page used in mobile and meta tagscopy
string - The text of the pagesearch_tags
array - Editor-specified list of tags to aid in internal searchsuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Press Releases
A press release on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - The type of page this record representsweb_url
string - The URL to this page on our websiteslug
string - A human-readable string used in the URLimage_url
string - The URL of an image representing this pagelisting_description
string - A brief description of the page used in listingsshort_description
string - A brief description of the page used in mobile and meta tagscopy
string - The text of the pagesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Educator Resources
An educator resource on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - The type of page this record representsweb_url
string - The URL to this page on our websiteslug
string - A human-readable string used in the URLimage_url
string - The URL of an image representing this pagelisting_description
string - A brief description of the page used in listingsshort_description
string - A brief description of the page used in mobile and meta tagscopy
string - The text of the pagesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Digital Catalogs
A digital catalog on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - The type of page this record representsweb_url
string - The URL to this page on our websiteslug
string - A human-readable string used in the URLimage_url
string - The URL of an image representing this pagelisting_description
string - A brief description of the page used in listingsshort_description
string - A brief description of the page used in mobile and meta tagscopy
string - The text of the pagesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index
# Printed Catalogs
A printed catalog on the website For a description of all the endpoints available for this resource, see here.
id
integer - Unique identifier of this resource. Taken from the source system.api_model
string - REST API resource type or endpointapi_link
string - REST API link for this resourcetitle
string - The name of this resourcetype
string - The type of page this record representsweb_url
string - The URL to this page on our websiteslug
string - A human-readable string used in the URLimage_url
string - The URL of an image representing this pagelisting_description
string - A brief description of the page used in listingsshort_description
string - A brief description of the page used in mobile and meta tagscopy
string - The text of the pagesuggest_autocomplete_boosted
object - Internal field to power the/autocomplete
endpoint. Do not use directly.suggest_autocomplete_all
object - Internal field to power the/autosuggest
endpoint. Do not use directly.last_updated_source
ISO 8601 date and time - Date and time the resource was updated in the source systemlast_updated
ISO 8601 date and time - Date and time the record was updated in the aggregator databasetimestamp
ISO 8601 date and time - Date and time the record was updated in the aggregator search index