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

  • 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 and title 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

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.

# 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 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 '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.

# 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:

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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - 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": 112786,
        "limit": 2,
        "offset": 0,
        "total_pages": 56393,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/artworks?page=2&limit=2"
    },
    "data": [
        {
            "id": 236548,
            "api_model": "artworks",
            "api_link": "https://api.artic.edu/api/v1/artworks/236548",
            "is_boosted": false,
            "title": "Mogabido",
            "alt_titles": null,
            ...
        },
        {
            "id": 240218,
            "api_model": "artworks",
            "api_link": "https://api.artic.edu/api/v1/artworks/240218",
            "is_boosted": false,
            "title": "Fragment II",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

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 query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 295,
        "limit": 10,
        "offset": 0,
        "total_pages": 30,
        "current_page": 1
    },
    "data": [
        {
            "_score": 251.02322,
            "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": null,
                "type": "iiif",
                "url": "https://www.artic.edu/iiif/2/5d2717cc-c619-fd84-49c4-62409bb1c04c",
                "lqip": null,
                "height": null
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://api.artic.edu/api/v1/artworks/16568",
            "id": 16568,
            "title": "Water Lilies",
            "timestamp": "2020-09-15T03:04:36-05:00"
        },
        {
            "_score": 232.57384,
            "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": null,
                "type": "iiif",
                "url": "https://www.artic.edu/iiif/2/ddae7b18-6c67-bfe7-f270-c999655b08c7",
                "lqip": null,
                "height": null
            },
            "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": "2020-09-15T03:04:36-05:00"
        },
        {
            "_score": 230.00996,
            "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": null,
                "type": "iiif",
                "url": "https://www.artic.edu/iiif/2/691c69c1-221a-1faf-14ea-7bc0c0a05fe2",
                "lqip": null,
                "height": null
            },
            "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": "2020-09-15T03:19:49-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-rc16"
    }
}
# 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/236548
{
    "data": {
        "id": 236548,
        "api_model": "artworks",
        "api_link": "https://api.artic.edu/api/v1/artworks/236548",
        "is_boosted": false,
        "title": "Mogabido",
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/236548/manifest.json
{
    "@context": "http://iiif.io/api/presentation/2/context.json",
    "@id": "https://api.artic.edu/api/v1/artworks/236548/manifest.json",
    "@type": "sc:Manifest",
    "label": "Mogabido",
    "description": [
        {
            "value": "",
            "language": "en"
        }
    ],
    "metadata": [
        {
            "label": "Artist / Maker",
            "value": "Moshekwa Langa\nSouth African, born 1975"
        },
        {
            "label": "Medium",
            "value": "Ink, graphite and acrylic on paper"
        },
        {
            "label": "Dimensions",
            "value": "140 \u00d7 100 cm (55 \u00d7 39 in.)"
        },
        {
            "label": "Object Number",
            "value": "2016.467"
        },
        {
            "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/236548",
        "format": "text/html",
        "label": "Full record"
    },
    "sequences": [
        {
            "@type": "sc:Sequence",
            "canvases": [
                {
                    "@type": "sc:Canvas",
                    "@id": "https://www.artic.edu/iiif/2/798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
                    "label": "1",
                    "width": 590,
                    "height": 822,
                    "images": [
                        {
                            "@type": "oa:Annotation",
                            "motivation": "sc:painting",
                            "on": "https://www.artic.edu/iiif/2/798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
                            "resource": {
                                "@type": "dctypes:Image",
                                "@id": "https://www.artic.edu/iiif/2/798c9e3b-203e-5ec8-753e-fdd3c0fa5f02/full/full/0/default.jpg",
                                "width": 590,
                                "height": 822,
                                "service": {
                                    "@context": "http://iiif.io/api/image/2/context.json",
                                    "@id": "https://www.artic.edu/iiif/2/798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
                                    "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - 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": 13891,
        "limit": 2,
        "offset": 0,
        "total_pages": 6946,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/agents?page=2&limit=2"
    },
    "data": [
        {
            "id": 48957,
            "api_model": "agents",
            "api_link": "https://api.artic.edu/api/v1/agents/48957",
            "title": "Lutz Bacher",
            "sort_title": "Bacher, Lutz",
            "alt_titles": null,
            ...
        },
        {
            "id": 34988,
            "api_model": "agents",
            "api_link": "https://api.artic.edu/api/v1/agents/34988",
            "title": "Winslow Homer",
            "sort_title": "Homer, Winslow",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search agents data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 14111,
        "limit": 10,
        "offset": 0,
        "total_pages": 1412,
        "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/2075",
            "id": 2075,
            "title": "Benard and Frey",
            "timestamp": "2020-09-15T04:11:01-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-rc16"
    }
}
# 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/48957
{
    "data": {
        "id": 48957,
        "api_model": "agents",
        "api_link": "https://api.artic.edu/api/v1/agents/48957",
        "title": "Lutz Bacher",
        "sort_title": "Bacher, Lutz",
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/places?limit=2
{
    "pagination": {
        "total": 3918,
        "limit": 2,
        "offset": 0,
        "total_pages": 1959,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/places?page=2&limit=2"
    },
    "data": [
        {
            "id": -37,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-37",
            "title": "Cape Town",
            "type": "No location",
            "last_updated_source": "2020-08-11T06:46:44-05:00",
            ...
        },
        {
            "id": -2147473261,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147473261",
            "title": "Joliet",
            "type": "No location",
            "last_updated_source": "2020-06-23T10:54:15-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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search places data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 3927,
        "limit": 10,
        "offset": 0,
        "total_pages": 393,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147483613",
            "id": -2147483613,
            "title": "Peoria",
            "timestamp": "2020-09-15T04:13:27-05:00"
        },
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147483581",
            "id": -2147483581,
            "title": "Askov",
            "timestamp": "2020-09-15T04:13:27-05:00"
        },
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147483534",
            "id": -2147483534,
            "title": "Z\u00fcrich",
            "timestamp": "2020-09-15T04:13:27-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-rc16"
    }
}
# 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/-37
{
    "data": {
        "id": -37,
        "api_model": "places",
        "api_link": "https://api.artic.edu/api/v1/places/-37",
        "title": "Cape Town",
        "type": "No location",
        "last_updated_source": "2020-08-11T06:46:44-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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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": 24317,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/24317",
            "title": "Gallery 189 (Corridor)",
            "type": "AIC Gallery",
            "is_closed": false,
            ...
        },
        {
            "id": 2705,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/2705",
            "title": "Gallery 59",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search galleries data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": "2020-09-15T04:13:33-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": "2020-09-15T04:13:33-05:00"
        },
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/2705",
            "id": 2705,
            "title": "Gallery 59",
            "timestamp": "2020-09-15T04:13:33-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-rc16"
    }
}
# 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/24317
{
    "data": {
        "id": 24317,
        "api_model": "galleries",
        "api_link": "https://api.artic.edu/api/v1/galleries/24317",
        "title": "Gallery 189 (Corridor)",
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - 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": 6082,
        "limit": 2,
        "offset": 0,
        "total_pages": 3041,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/exhibitions?page=2&limit=2"
    },
    "data": [
        {
            "id": 9531,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/9531",
            "title": "Richard Hunt: Scholar's Rock, or Stone of Hope, or Love of Bronze",
            "is_featured": false,
            "description": null,
            ...
        },
        {
            "id": 3070,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/3070",
            "title": "Van Gogh",
            "is_featured": false,
            "description": "When Vincent van Gogh decided to become an artist at the age of 27, he had already lived in 16 cities and had failed at five different professions. Though finally settled in his career, his home life was anything but\u2014Van Gogh remained a wanderer until his death 10 years later, despite his dream of a permanent home. With each move, the change in environment took his artistic aesthetic in a new direction. \n\nTo complement the exhibition Van Gogh\u2019s Bedrooms, which explores the theme of home in the artist\u2019s oeuvre, the Ryerson and Burnham Libraries present Van Gogh: In Search Of, a focused exhibition featuring photographs of the many residences and locales Van Gogh frequented over the course of his artistic career. \n\nThe selection of images, drawn largely from the libraries\u2019 own archives, were made possible by a friendship established between the Art Institute and the Van Gogh family in the 1940s. While preparing for a Van Gogh exhibition at the museum in 1949, Art Institute Director Daniel Catton Rich and Public Relations Counsel Peter Pollack visited the artist\u2019s nephew, Vincent Willem van Gogh, to ask for a loan of many of his uncle's paintings for the show. A close friendship among the men developed, and the three of them set out to visit most of the sites captured by the famous artist in his fabulous paintings. These site visits were documented by Pollack, a trained photographer. This remarkable assemblage of images offers a unique glimpse into the artist's life seen through the lens of the photographer.",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search exhibitions data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 6355,
        "limit": 10,
        "offset": 0,
        "total_pages": 636,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/5",
            "id": 5,
            "title": "Manet and the Sea",
            "timestamp": "2020-09-15T04:13:33-05:00"
        },
        {
            "_score": 1,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/6",
            "id": 6,
            "title": "Watercolors by Winslow Homer: The Color of Light",
            "timestamp": "2020-09-15T04:13:33-05:00"
        },
        {
            "_score": 1,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/7",
            "id": 7,
            "title": "Drawings in Dialogue: Old Masters through Modern, The Harry B. and Bessie K. Braude Memorial Collection",
            "timestamp": "2020-09-15T04:13:33-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-rc16"
    }
}
# 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/9531
{
    "data": {
        "id": 9531,
        "api_model": "exhibitions",
        "api_link": "https://api.artic.edu/api/v1/exhibitions/9531",
        "title": "Richard Hunt: Scholar's Rock, or Stone of Hope, or Love of Bronze",
        "is_featured": false,
        "description": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/29
{
    "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",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/434
{
    "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",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/48
{
    "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",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/54
{
    "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",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/62
{
    "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",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/catalogues?limit=2
{
    "pagination": {
        "total": 1101,
        "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": 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",
            ...
        },
        {
            "id": 535,
            "api_model": "catalogues",
            "api_link": "https://api.artic.edu/api/v1/catalogues/535",
            "title": "Thuillier",
            "last_updated_source": "2019-07-23T05:05:59-05:00",
            "last_updated": "2019-07-23T05:10:47-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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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/536
{
    "data": {
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/category-terms?limit=2
{
    "pagination": {
        "total": 9185,
        "limit": 2,
        "offset": 0,
        "total_pages": 4593,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/category-terms?page=2&limit=2"
    },
    "data": [
        {
            "id": "TM-14479",
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/TM-14479",
            "title": "hand woven",
            "subtype": "technique",
            "parent_id": null,
            ...
        },
        {
            "id": "TM-14478",
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/TM-14478",
            "title": "computer-assisted Jacquard loom",
            "subtype": "technique",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search category-terms data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 9189,
        "limit": 10,
        "offset": 0,
        "total_pages": 919,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/PC-825",
            "id": "PC-825",
            "title": "Women artists",
            "timestamp": "2020-09-15T04:15:35-05:00"
        },
        {
            "_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": "2020-09-15T04:15:35-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": "2020-09-15T04:15: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-rc16"
    }
}
# 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/TM-14479
{
    "data": {
        "id": "TM-14479",
        "api_model": "category-terms",
        "api_link": "https://api.artic.edu/api/v1/category-terms/TM-14479",
        "title": "hand woven",
        "subtype": "technique",
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

# Assets

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 /assets

A list of all assets 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/assets?limit=2
{
    "pagination": {
        "total": 145124,
        "limit": 2,
        "offset": 0,
        "total_pages": 72562,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/assets?page=2&limit=2"
    },
    "data": [
        {
            "id": "798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
            "lake_guid": "798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
            "api_model": "assets",
            "api_link": "https://api.artic.edu/api/v1/assets/798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
            "title": "278842",
            "type": "image",
            ...
        },
        {
            "id": "e4d1214c-9756-3519-93e9-0f8e6e31840f",
            "lake_guid": "e4d1214c-9756-3519-93e9-0f8e6e31840f",
            "api_model": "assets",
            "api_link": "https://api.artic.edu/api/v1/assets/e4d1214c-9756-3519-93e9-0f8e6e31840f",
            "title": "IM022580",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}
# GET /assets/{id}

A single asset by the given identifier. {id} is the identifier from our collections management system.

# 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/images?limit=2
{
    "pagination": {
        "total": 141947,
        "limit": 2,
        "offset": 0,
        "total_pages": 70974,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/images?page=2&limit=2"
    },
    "data": [
        {
            "id": "798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
            "lake_guid": "798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
            "api_model": "images",
            "api_link": "https://api.artic.edu/api/v1/images/798c9e3b-203e-5ec8-753e-fdd3c0fa5f02",
            "title": "278842",
            "type": "image",
            ...
        },
        {
            "id": "e4d1214c-9756-3519-93e9-0f8e6e31840f",
            "lake_guid": "e4d1214c-9756-3519-93e9-0f8e6e31840f",
            "api_model": "images",
            "api_link": "https://api.artic.edu/api/v1/images/e4d1214c-9756-3519-93e9-0f8e6e31840f",
            "title": "IM022580",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search images data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 142128,
        "limit": 10,
        "offset": 0,
        "total_pages": 14213,
        "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-rc16"
    }
}
# 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search videos data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": "2020-09-15T06:18:47-05: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": "2020-09-15T06:18:48-05: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": "2020-09-15T06:18:48-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-rc16"
    }
}
# 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/sounds?limit=2
{
    "pagination": {
        "total": 1102,
        "limit": 2,
        "offset": 0,
        "total_pages": 551,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/sounds?page=2&limit=2"
    },
    "data": [
        {
            "id": "1ac585eb-257e-2b3b-1a07-8cf2a06d7e16",
            "lake_guid": "1ac585eb-257e-2b3b-1a07-8cf2a06d7e16",
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/1ac585eb-257e-2b3b-1a07-8cf2a06d7e16",
            "title": "Audio stop 963.mp3",
            "type": "sound",
            ...
        },
        {
            "id": "18526870-d924-4bc6-237b-da10fd586aaa",
            "lake_guid": "18526870-d924-4bc6-237b-da10fd586aaa",
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/18526870-d924-4bc6-237b-da10fd586aaa",
            "title": "Audio stop 818.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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search sounds data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 1102,
        "limit": 10,
        "offset": 0,
        "total_pages": 111,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/31bdc88e-581d-b744-022b-7e9571b95ff2",
            "id": "31bdc88e-581d-b744-022b-7e9571b95ff2",
            "title": "Audio Lecture: Winslow Homer, Artist and Angler",
            "timestamp": "2020-09-15T06:18:52-05:00"
        },
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/31c370a9-98de-3533-c14e-c91776c8bf82",
            "id": "31c370a9-98de-3533-c14e-c91776c8bf82",
            "title": "Audio Lecture: Mel Bochner Symposium, Introduction and Keynote",
            "timestamp": "2020-09-15T06:18:52-05:00"
        },
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/31ee173d-cd35-88ef-9362-61722a5e10bf",
            "id": "31ee173d-cd35-88ef-9362-61722a5e10bf",
            "title": "Audio stop 442.wav",
            "timestamp": "2020-09-15T06:18:52-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-rc16"
    }
}
# 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/texts?limit=2
{
    "pagination": {
        "total": 2071,
        "limit": 2,
        "offset": 0,
        "total_pages": 1036,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/texts?page=2&limit=2"
    },
    "data": [
        {
            "id": "6f45a6b5-784e-4a59-46d7-99e066cd29f6",
            "lake_guid": "6f45a6b5-784e-4a59-46d7-99e066cd29f6",
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/6f45a6b5-784e-4a59-46d7-99e066cd29f6",
            "title": "Audio Transcript 963.txt",
            "type": "text",
            ...
        },
        {
            "id": "3c6168fb-d604-0ea8-6cc5-2b55b716b8e3",
            "lake_guid": "3c6168fb-d604-0ea8-6cc5-2b55b716b8e3",
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/3c6168fb-d604-0ea8-6cc5-2b55b716b8e3",
            "title": "Audio Transcript 963-1.txt",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search texts data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 2071,
        "limit": 10,
        "offset": 0,
        "total_pages": 208,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/52d442ca-eebc-67ab-3708-9fe55d11a01e",
            "id": "52d442ca-eebc-67ab-3708-9fe55d11a01e",
            "title": "Audio transcript 761.txt",
            "timestamp": "2020-09-15T06:19:19-05:00"
        },
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/52fd5b29-9622-a131-9797-a2d074dba3d9",
            "id": "52fd5b29-9622-a131-9797-a2d074dba3d9",
            "title": "AIC1929PandS42ndAn_comb.pdf",
            "timestamp": "2020-09-15T06:19:19-05:00"
        },
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/53770d6a-7bcd-494c-49e2-e8fd4a7914ae",
            "id": "53770d6a-7bcd-494c-49e2-e8fd4a7914ae",
            "title": "AIC1911ArtSdtLge17thAn_comb.pdf",
            "timestamp": "2020-09-15T06:19:19-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-rc16"
    }
}
# GET /texts/{id}

A single text by the given identifier. {id} is the identifier from our collections management system.

# Shop

# Shop Categories

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 /shop-categories

A list of all shop-categories 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • children
Example request: https://api.artic.edu/api/v1/shop-categories?limit=2
{
    "pagination": {
        "total": 87,
        "limit": 2,
        "offset": 0,
        "total_pages": 44,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/shop-categories?page=2&limit=2"
    },
    "data": [
        {
            "id": 56,
            "api_model": "shop-categories",
            "api_link": "https://api.artic.edu/api/v1/shop-categories/56",
            "title": "Totes",
            "web_url": "http://shop.artic.edu/browse.aspx?catID=56",
            "parent_id": 3,
            ...
        },
        {
            "id": 53,
            "api_model": "shop-categories",
            "api_link": "https://api.artic.edu/api/v1/shop-categories/53",
            "title": "Religious",
            "web_url": "http://shop.artic.edu/browse.aspx?catID=53",
            "parent_id": 6,
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search shop-categories data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/shop-categories/search
{
    "preference": null,
    "pagination": {
        "total": 87,
        "limit": 10,
        "offset": 0,
        "total_pages": 9,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "shop-categories",
            "api_link": "https://api.artic.edu/api/v1/shop-categories/2",
            "id": 2,
            "title": "Books & Prints",
            "timestamp": "2020-09-15T06:19:27-05:00"
        },
        {
            "_score": 1,
            "api_model": "shop-categories",
            "api_link": "https://api.artic.edu/api/v1/shop-categories/3",
            "id": 3,
            "title": "Fashion & Accessories",
            "timestamp": "2020-09-15T06:19:27-05:00"
        },
        {
            "_score": 1,
            "api_model": "shop-categories",
            "api_link": "https://api.artic.edu/api/v1/shop-categories/4",
            "id": 4,
            "title": "Decor",
            "timestamp": "2020-09-15T06:19:27-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-rc16"
    }
}
# GET /shop-categories/{id}

A single shop-category by the given identifier.

Example request: https://api.artic.edu/api/v1/shop-categories/56
{
    "data": {
        "id": 56,
        "api_model": "shop-categories",
        "api_link": "https://api.artic.edu/api/v1/shop-categories/56",
        "title": "Totes",
        "web_url": "http://shop.artic.edu/browse.aspx?catID=56",
        "parent_id": 3,
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

# 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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/products?limit=2
{
    "pagination": {
        "total": 1,
        "limit": 2,
        "offset": 0,
        "total_pages": 1,
        "current_page": 1
    },
    "data": [
        {
            "id": 64,
            "api_model": "products",
            "api_link": "https://api.artic.edu/api/v1/products/64",
            "title": "Chagall America Windows Silk Tie",
            "title_sort": null,
            "parent_id": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search products data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 7026,
        "limit": 10,
        "offset": 0,
        "total_pages": 703,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "products",
            "api_link": "https://api.artic.edu/api/v1/products/37",
            "id": 37,
            "title": "Sullivan Scarf",
            "timestamp": "2020-09-15T06:19:27-05:00"
        },
        {
            "_score": 1,
            "api_model": "products",
            "api_link": "https://api.artic.edu/api/v1/products/38",
            "id": 38,
            "title": "Butterfly Scarf",
            "timestamp": "2020-09-15T06:19:27-05:00"
        },
        {
            "_score": 1,
            "api_model": "products",
            "api_link": "https://api.artic.edu/api/v1/products/39",
            "id": 39,
            "title": "Davis Ready to Wear Scarf",
            "timestamp": "2020-09-15T06:19:27-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-rc16"
    }
}
# GET /products/{id}

A single product by the given identifier.

Example request: https://api.artic.edu/api/v1/products/64
{
    "data": {
        "id": 64,
        "api_model": "products",
        "api_link": "https://api.artic.edu/api/v1/products/64",
        "title": "Chagall America Windows Silk Tie",
        "title_sort": null,
        "parent_id": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - 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": 15,
        "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": 3246,
            "api_model": "tours",
            "api_link": "https://api.artic.edu/api/v1/tours/3246",
            "title": "Verbal Description tour: The Essentials",
            "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/IM016907_020.jpg",
            "description": "<p>Designed for people with impaired vision: Discover our Essentials Tour.</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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search tours data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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-rc16"
    }
}
# GET /tours/{id}

A single tour by the given identifier.

Example request: https://api.artic.edu/api/v1/tours/3246
{
    "data": {
        "id": 3246,
        "api_model": "tours",
        "api_link": "https://api.artic.edu/api/v1/tours/3246",
        "title": "Verbal Description tour: The Essentials",
        "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/IM016907_020.jpg",
        "description": "<p>Designed for people with impaired vision: Discover our Essentials Tour.</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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/mobile-sounds?limit=2
{
    "pagination": {
        "total": 786,
        "limit": 2,
        "offset": 0,
        "total_pages": 393,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/mobile-sounds?page=2&limit=2"
    },
    "data": [
        {
            "id": 4716,
            "api_model": "mobile-sounds",
            "api_link": "https://api.artic.edu/api/v1/mobile-sounds/4716",
            "title": "Audio Dispatch: Redesigning \"Monet and Chicago\"",
            "web_url": "https://www.artic.edu/mobile/audio/AD_MonetRedesign_V5%20%281%29.mp3",
            "transcript": null,
            ...
        },
        {
            "id": 4703,
            "api_model": "mobile-sounds",
            "api_link": "https://api.artic.edu/api/v1/mobile-sounds/4703",
            "title": "4887_T036_Irises_V5.mp3",
            "web_url": "https://www.artic.edu/mobile/audio/11_4887_Irises_V5.mp3",
            "transcript": "<p>Narrator: Curator, Gloria Groom.</p>\n<p>Gloria Groom: This, I think, is one of the most unusual waterlily series that Monet ever did. These are all six feet tall, square canvases where he is so much interested, yes, in the reflective quality but even more so in the kind of building up of this encrusted surface scraping back, adding, scraping back, adding. And you get this almost fresco like encrusted [ph?] surface that looks like it belongs to the wall.</p>\n<p>Narrator: Researcher Associate, Kathryn Kremnitzer.</p>\n<p>Kathryn Kremnitzer: The composition is almost dizzying. You know, we think of Monet painting these at the edge of the pond looking into the reflection seeing things on the surface and below. It feels upside down because you don\u2019t know what\u2019s up and what is down.</p>\n<p>Gloria Groom: Where are we? What is reflected? What\u2019s growing up from the water? And what\u2019s being reflected into the water? This back-and-forth thing, those qualities that were so attractive in the 1950s for the abstract expressionists. And why when his son Michel started selling off some of these large scale canvases that had been left in his studio, someone like Kathryn Kuh, who was the Art Institute\u2019s first curator of modern and contemporary art just fell in love with this and had to have it.</p>\n<p>Kathryn Kremnitzer: This truly pioneering curator of modern art purchased irises from Katia Granoff\u2019s gallery in Paris.</p>\n<p>Gloria Groom: Interestingly enough beat out Alfred Barr\u2026</p>\n<p>Kathryn Kremnitzer: \u2026who\u2019s the director of the Museum of Modern Art in New York. Thinking about what is modern art in 1956 you might not think Monet and the Art Institute already had so many inimitable examples by the artist, why strengthen your collection that way?</p>\n<p>Gloria Groom: Kathryn Kuh absolutely saw in this what was going on in America at the same time with abstract expressionist, with color field painting.</p>\n<p>Kathryn Kremnitzer: It\u2019s totally immersive. And it sets up moments of abstraction or pure color that in the twentieth century will take center stage.</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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search mobile-sounds data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 793,
        "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": "2020-09-15T06:20: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-rc16"
    }
}
# GET /mobile-sounds/{id}

A single mobile-sound by the given identifier.

Example request: https://api.artic.edu/api/v1/mobile-sounds/4716
{
    "data": {
        "id": 4716,
        "api_model": "mobile-sounds",
        "api_link": "https://api.artic.edu/api/v1/mobile-sounds/4716",
        "title": "Audio Dispatch: Redesigning \"Monet and Chicago\"",
        "web_url": "https://www.artic.edu/mobile/audio/AD_MonetRedesign_V5%20%281%29.mp3",
        "transcript": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search publications data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": "2020-09-15T06:20:31-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": "2020-09-15T06:20:31-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": "2020-09-15T06:20:31-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-rc16"
    }
}
# GET /publications/{id}

A single publication by the given identifier.

Example request: https://api.artic.edu/api/v1/publications/141096
{
    "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",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search sections data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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/464649",
            "id": 464649,
            "title": "Acknowledgments",
            "timestamp": "2020-09-15T06:20:37-05:00"
        },
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/466580",
            "id": 466580,
            "title": "Introduction",
            "timestamp": "2020-09-15T06:20:37-05:00"
        },
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/467547",
            "id": 467547,
            "title": "Works of Art",
            "timestamp": "2020-09-15T06:20: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-rc16"
    }
}
# GET /sections/{id}

A single section by the given identifier.

Example request: https://api.artic.edu/api/v1/sections/128775
{
    "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,
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search sites data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": "2020-09-15T06:20:52-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": "2020-09-15T06:20:52-05:00"
        },
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://api.artic.edu/api/v1/sites/3",
            "id": 3,
            "title": "Curious Corner",
            "timestamp": "2020-09-15T06:20:52-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-rc16"
    }
}
# GET /sites/{id}

A single site by the given identifier.

Example request: https://api.artic.edu/api/v1/sites/104
{
    "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/",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/closures?limit=2
{
    "pagination": {
        "total": 20,
        "limit": 2,
        "offset": 0,
        "total_pages": 10,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/closures?page=2&limit=2"
    },
    "data": [
        {
            "id": 26,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/26",
            "title": "Lorem ipsum.",
            "date_start": "2020-08-11T00:00:00-05:00",
            "date_end": "2020-08-12T00:00:00-05:00",
            ...
        },
        {
            "id": 24,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/24",
            "title": "Lorem ipsum.",
            "date_start": "2020-08-06T00:00:00-05:00",
            "date_end": "2020-08-07T00: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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search closures data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 21,
        "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": "2020-09-15T06:20:54-05:00"
        },
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/5",
            "id": 5,
            "title": "Lorem ipsum.",
            "timestamp": "2020-09-15T06:20:54-05:00"
        },
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/9",
            "id": 9,
            "title": "Lorem ipsum.",
            "timestamp": "2020-09-15T06:20:54-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-rc16"
    }
}
# GET /closures/{id}

A single closure by the given identifier.

Example request: https://api.artic.edu/api/v1/closures/26
{
    "data": {
        "id": 26,
        "api_model": "closures",
        "api_link": "https://api.artic.edu/api/v1/closures/26",
        "title": "Lorem ipsum.",
        "date_start": "2020-08-11T00:00:00-05:00",
        "date_end": "2020-08-12T00: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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/web-exhibitions?limit=2
{
    "pagination": {
        "total": 386,
        "limit": 2,
        "offset": 0,
        "total_pages": 193,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/web-exhibitions?page=2&limit=2"
    },
    "data": [
        {
            "id": 692,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/692",
            "title": "Richard Hunt: Scholar's Rock, or Stone of Hope, or Love of Bronze",
            "exhibition_id": 9531,
            "is_featured": false,
            ...
        },
        {
            "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,
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search web-exhibitions data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 680,
        "limit": 10,
        "offset": 0,
        "total_pages": 68,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "web-exhibitions",
            "api_link": "https://aggregator-data.artic.edu/api/v1/web-exhibitions/673",
            "id": 673,
            "title": "**DELETED** A&D TBD",
            "timestamp": "2019-11-22T15:02:14-06:00"
        },
        {
            "_score": 1,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/1",
            "id": 1,
            "title": "Charles White: A Retrospective",
            "timestamp": "2020-09-15T06:20:54-05:00"
        },
        {
            "_score": 1,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/2",
            "id": 2,
            "title": "Manet and Modern Beauty",
            "timestamp": "2020-09-15T06:20:54-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-rc16"
    }
}
# GET /web-exhibitions/{id}

A single web-exhibition by the given identifier.

Example request: https://api.artic.edu/api/v1/web-exhibitions/692
{
    "data": {
        "id": 692,
        "api_model": "web-exhibitions",
        "api_link": "https://api.artic.edu/api/v1/web-exhibitions/692",
        "title": "Richard Hunt: Scholar's Rock, or Stone of Hope, or Love of Bronze",
        "exhibition_id": 9531,
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - 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": 105,
        "limit": 2,
        "offset": 0,
        "total_pages": 53,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/events?page=2&limit=2"
    },
    "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,
            "image_url": "https://artic-web.imgix.net/22a002db-9695-452b-9c85-7a63644df4e0/G35154-int_press.jpg?rect=0%2C349%2C2334%2C1312&auto=compress&fm=jpg&q=80&fit=crop&crop=faces%2Cedges%2Centropy&w=1200&h=675",
            ...
        },
        {
            "id": 2995,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/2995",
            "title": "Screening: H\u00e9lio Oiticica",
            "title_display": null,
            "image_url": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search events data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 2019,
        "limit": 10,
        "offset": 0,
        "total_pages": 202,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/4937",
            "id": 4937,
            "title": "Monet and Chicago",
            "timestamp": "2020-01-07T06:08:28-06:00"
        },
        {
            "_score": 1,
            "api_model": "events",
            "api_link": "https://aggregator-data.artic.edu/api/v1/events/4938",
            "id": 4938,
            "title": "Monet and Chicago",
            "timestamp": "2020-01-07T06:08:28-06:00"
        },
        {
            "_score": 1,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/3093",
            "id": 3093,
            "title": "Performance and Drop-In Workshop: Parangol\u00e9s and Samba",
            "timestamp": "2020-09-15T06:20:59-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-rc16"
    }
}
# 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,
        "image_url": "https://artic-web.imgix.net/22a002db-9695-452b-9c85-7a63644df4e0/G35154-int_press.jpg?rect=0%2C349%2C2334%2C1312&auto=compress&fm=jpg&q=80&fit=crop&crop=faces%2Cedges%2Centropy&w=1200&h=675",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/event-occurrences?limit=2
{
    "pagination": {
        "total": 2,
        "limit": 2,
        "offset": 0,
        "total_pages": 1,
        "current_page": 1
    },
    "data": [
        {
            "id": "80f6ec5d-556c-50fa-8f98-448d224a405e",
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/80f6ec5d-556c-50fa-8f98-448d224a405e",
            "title": "Virtual Lecture: Fred Wilson",
            "event_id": 5046,
            "short_description": "Presented by the Society for Contemporary Art with the School of the Art Institute of Chicago's Visiting Artists Program",
            ...
        },
        {
            "id": "e47cc49e-b658-58f4-97c4-04039e5a4a4b",
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/e47cc49e-b658-58f4-97c4-04039e5a4a4b",
            "title": "Virtual Lecture: El Greco\u2014Ambition and Defiance",
            "event_id": 5041,
            "short_description": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search event-occurrences data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 27,
        "limit": 10,
        "offset": 0,
        "total_pages": 3,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/3118cc7e-f36d-5244-b42f-980e213fb9f9",
            "id": "3118cc7e-f36d-5244-b42f-980e213fb9f9",
            "title": "Virtual Educator Program: Introduction to Museum Resources",
            "timestamp": "2020-09-15T06:21:17-05:00"
        },
        {
            "_score": 1,
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/458872bb-00bb-5bcd-8a18-0e4b44f0f289",
            "id": "458872bb-00bb-5bcd-8a18-0e4b44f0f289",
            "title": "Virtual Educator Program: Introduction to Museum Resources",
            "timestamp": "2020-09-15T06:21:17-05:00"
        },
        {
            "_score": 1,
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/477a6b63-6439-5992-8ba3-a47428d31881",
            "id": "477a6b63-6439-5992-8ba3-a47428d31881",
            "title": "Conservation Perspectives: Malangatana\u2014Mozambique Modern",
            "timestamp": "2020-09-15T06:21:17-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-rc16"
    }
}
# GET /event-occurrences/{id}

A single event-occurrence by the given identifier.

Example request: https://api.artic.edu/api/v1/event-occurrences/80f6ec5d-556c-50fa-8f98-448d224a405e
{
    "data": {
        "id": "80f6ec5d-556c-50fa-8f98-448d224a405e",
        "api_model": "event-occurrences",
        "api_link": "https://api.artic.edu/api/v1/event-occurrences/80f6ec5d-556c-50fa-8f98-448d224a405e",
        "title": "Virtual Lecture: Fred Wilson",
        "event_id": 5046,
        "short_description": "Presented by the Society for Contemporary Art with the School of the Art Institute of Chicago's Visiting Artists Program",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/event-programs?limit=2
{
    "pagination": {
        "total": 67,
        "limit": 2,
        "offset": 0,
        "total_pages": 34,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/event-programs?page=2&limit=2"
    },
    "data": [
        {
            "id": 6,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/6",
            "title": "Artists Connect",
            "is_affiliate_group": false,
            "is_event_host": false,
            ...
        },
        {
            "id": 5,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/5",
            "title": "American Sign Language Tours",
            "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search event-programs data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 68,
        "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": "2020-09-15T06:21:17-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": "2020-09-15T06:21:17-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": "2020-09-15T06:21:17-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-rc16"
    }
}
# GET /event-programs/{id}

A single event-program by the given identifier.

Example request: https://api.artic.edu/api/v1/event-programs/5
{
    "data": {
        "id": 5,
        "api_model": "event-programs",
        "api_link": "https://api.artic.edu/api/v1/event-programs/5",
        "title": "American Sign Language Tours",
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/articles?limit=2
{
    "pagination": {
        "total": 253,
        "limit": 2,
        "offset": 0,
        "total_pages": 127,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/articles?page=2&limit=2"
    },
    "data": [
        {
            "id": 705,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/705",
            "title": "hidden-materials-in-john-singer-sargents-watercolors",
            "date": "2018-08-01T00:00:00-05:00",
            "copy": " While John Singer Sargent is most widely known for his oil portraits of august men and women in fashionable interiors, he cultivated a love of painting outdoors from an early age. As a boy he recorded his family\u2019s European travels in sketchbooks, and as his talent and repertoire grew, he acquired numerous accoutrements such as portable easels, sketching umbrellas, rigid pads of paper, and compact palettes of watercolors that allowed him to paint multiple pictures during one outing, even in challenging conditions. In fact, Sargent was an official war artist for Britain during World War I and spent four months on the front painting and sketching.   A fellow war artist, Henry Tonks, painted this watercolor caricature of Sargent in 1918, depicting the artist clothed in army greens and shielded by a sketching umbrella that Sargent camouflaged for the purpose. The painting (held in the collection of the Museum of Fine Arts in Boston, and not a part of this exhibition) gives new meaning to challenging conditions\u2014and shows us a glimpse of Sargent\u2019s life apart from glamorous portraits.   In preparation for the current exhibition John Singer Sargent and Chicago\u2019s Gilded Age , Art Institute curators, conservators, and conservation scientists examined some of Sargent\u2019s paintings and investigated his less obvious materials, finding evidence that provides valuable insight into the artist\u2019s working process. A Newsworthy Surprise Sargent captured hundreds of landscapes in watercolor as he traveled across Europe and North America. In 1908 he painted Tarragona Terrace and Garden when he visited the eastern coast of Spain. Seated in the arcade of Tarragona\u2019s cathedral, Sargent made a quick study of its columns.   While he generally preferred to leave parts of the paper bare to delineate highlights, the foliage in the upper left corner of this picture was painted using a different technique. Here it appears that Sargent simply laid in a mass of greens and browns and then returned with an opaque, zinc white paint to create his highlights. In order to fully conceal the dark colors underneath, Sargent had to use thick dabs of white as if he were making a correction in oils. Sargent often made multiple paintings in one day and would interleave his paintings with sheets of newspaper for protection as he carried them. He did this with Tarragona Terrace and Garden , perhaps not realizing that the thickly applied areas of paint had not dried completely when he laid the newspaper on its surface. As an unintended consequence, fragments from a Spanish newspaper stuck to the painting, remnants of Sargent\u2019s panting process that survive today.   In normal light these tiny pieces of newsprint are barely noticeable, but they stand out in an infrared photograph, which makes some of the Spanish text almost legible.   Wax in a Watercolor Nearly 10 years after he painted Tarragona Terrace and Garden , Sargent made another series of stunning architectural studies while visiting his friends Charles and James Deering in Florida. Sargent was drawn to Vizcaya, the lavish estate that James had recently built, not least of all because it reminded him of the Italian landscapes and gardens that he loved to paint.   Analytical instruments in the conservation science lab at the Art Institute can help answer a lot of questions about artists\u2019 materials. In the case of this work, scientists sought more information about a soft, translucent material found in discrete areas on its surface. The material was analyzed and determined to be a wax, which Sargent used as a \u201cresist\u201d\u2014meaning that he marked the paper with a transparent material that would repel the water-based paint and leave highlights in the composition.   Analysis also revealed that the wax is a type called spermaceti, a product obtained from sperm whales and a major commercial product of the whaling industry. In Sargent\u2019s time this wax was commonly used to make candles. Finding it here helps to explain Sargent\u2019s process\u2014because spermaceti is softer than other common waxes such as beeswax, it would have been the logical choice for use as a drawing material. To learn more about Sargent\u2019s process and materials come visit John Singer Sargent and Chicago\u2019s Gilded Age in the Art Institute\u2019s Regenstein Hall through September 30, and check out the technical essay in the exhibition catalogue . \u2014Mary Broadway, associate conservator of prints and drawings ",
            ...
        },
        {
            "id": 696,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/696",
            "title": "encounter-with-unusual-photo-paper",
            "date": "2018-06-13T00:00:00-05:00",
            "copy": " Recently, a photograph by Kenneth Heilbron (American, 1903\u20131997), was brought to the photography conservation lab to be prepared for exhibition. Heilbron, a Chicago-based photographer who became the School of the Art Institute\u2019s first instructor of photography in 1939, was perhaps best known for his assignment work for Time , Fortune , and Life magazines. This 1940s image of two women standing along Michigan Avenue typifies the advertising work that Heilbron did for Chicago\u2019s Marshall Field\u2019s department store.   One of the most interesting and challenging aspects of photography conservation is to properly identify photographic processes, which differ not only in terms of the visual images they produce but in the materials used to create the print. Accurate knowledge of process is essential because it impacts the conservator\u2019s approach, as different materials sometimes require different treatments. Observing the print under the stereomicroscope, I discovered a very porous surface unlike that of any photographic paper I had seen before. With the help of the department\u2019s senior conservator, Sylvie Penichon, the paper was identified as Gevaluxe Velours, a photographic paper produced in Belgium between 1930 and 1950 by Gevaert Photo-Producten NV. Its unusual surface was created by dusting fibrous material on a sheet of paper coated with adhesive before it was sensitized. Under the microscope, the surface of the paper looks extremely fragile and soft, but it is actually quite rough to the touch\u2014a little like sandpaper. Unlike sandpaper, however, it will easily scratch if a hard object comes in contact with the surface. The damage can be superficial\u2014surface fibers may be disrupted and reflect light differently. Or the fiber can be completely removed, creating a loss that exposes the white underlying paper support. Once the structure and materials of the photographic paper were determined, I began conservation treatment based on two main criteria: long-term stability and visual appearance. First, the cardboard support on which the print is mounted was cleaned, and the delaminated and brittle edges were repaired with wheat starch paste\u2014a very stable, reversible, and long-lasting adhesive commonly used in conservation. Then, under the microscope and with the help of tweezers, I removed, one by one, every fiber and visible dust spec that was caught in the fibrous material.   The scratches were then inpainted using a very fine brush and watercolors. The first tests were done under the stereomicroscope, but once I understood how the surface was reacting to the application of paint, I completed the inpainting on an easel using magnifiers. The tone was then gradually built up with successive thin applications of color. This technique ensured that the inpainting blended in and would be virtually undetectable. The key with this technique is to know when to stop!   By cleaning the surface of the print and reducing the appearance of the scratches, the subject of the photograph\u2014as well as its unique surface\u2014can be fully appreciated.   This interesting print is currently on display in Gallery 10, where a selection of highlights of the Art Institute photography collection complements the exhibition Never a Lovely So Real: Photography and Film in Chicago, 1950\u20131980 . It marks the first time this photograph has been on view since it was acquired in 2000. Come and see it in person! \u2014Marie-Lou Beauchamp, Andrew W. Mellon Fellow in Photograph Conservation, Department of Photography ",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search articles data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 284,
        "limit": 10,
        "offset": 0,
        "total_pages": 29,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/14",
            "id": 14,
            "title": "secrets-of-the-modern-wing",
            "timestamp": "2020-09-15T06:21:18-05:00"
        },
        {
            "_score": 1,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/18",
            "id": 18,
            "title": "your-move",
            "timestamp": "2020-09-15T06:21:18-05:00"
        },
        {
            "_score": 1,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/26",
            "id": 26,
            "title": "secrets-of-the-modern-wing-take-two",
            "timestamp": "2020-09-15T06:21:18-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-rc16"
    }
}
# GET /articles/{id}

A single article by the given identifier.

Example request: https://api.artic.edu/api/v1/articles/705
{
    "data": {
        "id": 705,
        "api_model": "articles",
        "api_link": "https://api.artic.edu/api/v1/articles/705",
        "title": "hidden-materials-in-john-singer-sargents-watercolors",
        "date": "2018-08-01T00:00:00-05:00",
        "copy": " While John Singer Sargent is most widely known for his oil portraits of august men and women in fashionable interiors, he cultivated a love of painting outdoors from an early age. As a boy he recorded his family\u2019s European travels in sketchbooks, and as his talent and repertoire grew, he acquired numerous accoutrements such as portable easels, sketching umbrellas, rigid pads of paper, and compact palettes of watercolors that allowed him to paint multiple pictures during one outing, even in challenging conditions. In fact, Sargent was an official war artist for Britain during World War I and spent four months on the front painting and sketching.   A fellow war artist, Henry Tonks, painted this watercolor caricature of Sargent in 1918, depicting the artist clothed in army greens and shielded by a sketching umbrella that Sargent camouflaged for the purpose. The painting (held in the collection of the Museum of Fine Arts in Boston, and not a part of this exhibition) gives new meaning to challenging conditions\u2014and shows us a glimpse of Sargent\u2019s life apart from glamorous portraits.   In preparation for the current exhibition John Singer Sargent and Chicago\u2019s Gilded Age , Art Institute curators, conservators, and conservation scientists examined some of Sargent\u2019s paintings and investigated his less obvious materials, finding evidence that provides valuable insight into the artist\u2019s working process. A Newsworthy Surprise Sargent captured hundreds of landscapes in watercolor as he traveled across Europe and North America. In 1908 he painted Tarragona Terrace and Garden when he visited the eastern coast of Spain. Seated in the arcade of Tarragona\u2019s cathedral, Sargent made a quick study of its columns.   While he generally preferred to leave parts of the paper bare to delineate highlights, the foliage in the upper left corner of this picture was painted using a different technique. Here it appears that Sargent simply laid in a mass of greens and browns and then returned with an opaque, zinc white paint to create his highlights. In order to fully conceal the dark colors underneath, Sargent had to use thick dabs of white as if he were making a correction in oils. Sargent often made multiple paintings in one day and would interleave his paintings with sheets of newspaper for protection as he carried them. He did this with Tarragona Terrace and Garden , perhaps not realizing that the thickly applied areas of paint had not dried completely when he laid the newspaper on its surface. As an unintended consequence, fragments from a Spanish newspaper stuck to the painting, remnants of Sargent\u2019s panting process that survive today.   In normal light these tiny pieces of newsprint are barely noticeable, but they stand out in an infrared photograph, which makes some of the Spanish text almost legible.   Wax in a Watercolor Nearly 10 years after he painted Tarragona Terrace and Garden , Sargent made another series of stunning architectural studies while visiting his friends Charles and James Deering in Florida. Sargent was drawn to Vizcaya, the lavish estate that James had recently built, not least of all because it reminded him of the Italian landscapes and gardens that he loved to paint.   Analytical instruments in the conservation science lab at the Art Institute can help answer a lot of questions about artists\u2019 materials. In the case of this work, scientists sought more information about a soft, translucent material found in discrete areas on its surface. The material was analyzed and determined to be a wax, which Sargent used as a \u201cresist\u201d\u2014meaning that he marked the paper with a transparent material that would repel the water-based paint and leave highlights in the composition.   Analysis also revealed that the wax is a type called spermaceti, a product obtained from sperm whales and a major commercial product of the whaling industry. In Sargent\u2019s time this wax was commonly used to make candles. Finding it here helps to explain Sargent\u2019s process\u2014because spermaceti is softer than other common waxes such as beeswax, it would have been the logical choice for use as a drawing material. To learn more about Sargent\u2019s process and materials come visit John Singer Sargent and Chicago\u2019s Gilded Age in the Art Institute\u2019s Regenstein Hall through September 30, and check out the technical essay in the exhibition catalogue . \u2014Mary Broadway, associate conservator of prints and drawings ",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/selections?limit=2
{
    "pagination": {
        "total": 13,
        "limit": 2,
        "offset": 0,
        "total_pages": 7,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/selections?page=2&limit=2"
    },
    "data": [
        {
            "id": 6,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/6",
            "title": "american-art",
            "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>",
            "copy": " Please note: artworks occasionally go off view for imaging, treatment, or loan to other institutions. Click on the images to ensure the work is currently on view.   Georgia O\u2019Keeffe didn't travel in an airplane until she was in her 70s, but when she did, she was fascinated. She started a series of paintings inspired by her in-flight experiences. The works began small and progressively got bigger until the final canvas in the series, Sky above Clouds IV , which is so large that it has never traveled since coming to the Art Institute.   One of America's most famous paintings, American Gothic , debuted at the Art Institute of Chicago, winning a $300 prize and instant fame for Grant Wood. It has long been parodied and is often seen as a satirical commentary on the Midwestern character, but Wood intended it to a positive statement about rural American values. Read more about this work on our blog, where a curator answers the top five FAQs about the iconic painting.   One of the best-known images of 20th-century art, Nighthawks depicts an all-night diner in which three customers, all lost in their own thoughts, have congregated. It's unclear how or why the anonymous and uncommunicative night owls are there\u2014in fact, Hopper eliminated any reference to an entrance to the diner. The four seem as separate and remote from the viewer as they are from one another. (The red-haired woman was actually modeled by the artist\u2019s wife, Jo.)   Known today for his paintings and murals depicting Mexican political and cultural life, Diego Rivera enjoyed a brief but sparkling period as a Cubist painter early in his career. In this work he portrayed his then-lover, the Russian-born painter and writer Marevna Vorob\u00ebv-Stebelska, clearly conveying her distinctive bobbed hair, blond bangs, and prominent nose\u2014despite or with the aid of the Cubist style. Like many other artists in Paris, Rivera rejected Cubism as frivolous and inappropriate following World War I and the Russian Revolution.   A native Chicagoan and graduate of the School of the Art Institute, Archibald Motley used his art to represent the vibrancy of African American culture, frequently portraying young, sophisticated city dwellers out on the town. One of Motley\u2019s most celebrated paintings, Nightlife depicts a crowded cabaret in the South Side neighborhood of Bronzeville. The dynamic composition, intense lighting, and heightened colors vividly express the liveliness of the scene.   The only American artist invited to exhibit with the French Impressionists, Mary Cassatt concentrated on the human figure, particularly on sensitive yet unsentimental portrayals of women and children. In The Child\u2019s Bath , one of Cassatt\u2019s masterworks, she used cropped forms, bold patterns and outlines, and a flattened perspective, all of which she derived from her study of Japanese woodblock prints.   Eldzier Cortor lived in Chicago and attended the School of the Art Institute, and while drawn to abstraction, he felt that it was not an effective tool for conveying serious social and political concerns. In The Room No. VI, the artist exposes the impoverished living conditions experienced by many African Americans on the South Side through a brilliant use of line and color, reinvigorating the idiom of social realism.   Though Stuart Davis studied with the so-called Ashcan School, who sought to depict a realistic look at modern urban life, he came to embrace a more abstracted and energetic style, as seen in Ready-to-Wear . The bright colors intersect and interrupt one another in a distinctly American way: jazzy, vital, and mass produced\u2014all qualities summed up in the title.   In addition to architecture, Frank Lloyd Wright designed furniture like this chair from his home in Oak Park, Illinois. Though his early experiments were heavy, solid cube chairs, he eventually added the refinements seen in this design, such as spindles, the subtly tapering crest rail, and gently curving leg ends, all of which produce an effect that is equal parts sophistication and simplicity.   In The Herring Net, Winslow Homer depicts two fishermen at their daily yet heroic work. As the small boat rides the swells, one fisherman hauls in the heavy net while the other unloads the glistening herring, illustrating that teamwork is essential for survival on this churning sea that both gives and takes. ",
            ...
        },
        {
            "id": 5,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/5",
            "title": "impressionism",
            "short_copy": "<p>The Art Institute\u2019s holdings of late 19th-century French art are among the largest and finest in the world and feature some of the most well-known and well-loved works in the museum. The works included here are highlights from our wide-ranging collection.</p>",
            "copy": " Pierre-August Renoir's painting of two boaters and their female friend enjoying a lunch alfresco is the picture of idyllic pleasure. Renoir likely created this painting during an extended stay at the restaurant it depicts\u2014the Maison Fournaise, along the Seine. He completed many scenes of boating life during this period.   In this work, Berthe Morisot captures the essence of modern life in understated terms\u2014rendering her subject with soft, feathery brushstrokes in nuanced shades of lavender, pink, blue, white, and gray. The composition resembles a visual tone poem, orchestrated with such perfumed and rarified motifs as brushed blonde hair, satins, powder puffs, and \ufb02ower petals. Morisot exhibited in seven of the eight Impressionist group shows; this painting was included in the fifth exhibition, in 1880, where her work received great acclaim.   This monumental view of a bustling Parisian intersection is considered Caillebotte\u2019s masterpiece. In it, the artist captures a scene of sweeping modernity that conveys the momentary quality of everyday life, depicting fashionable city dwellers strolling down the street on a rainy day. The painting\u2019s rigorous perspective and grand scale pleased Parisian audiences, while its asymmetry, unusually cropped forms, and rain-washed mood stimulated a more radical sensibility.   The hat\u2014a prime symbol of the modern bourgeois woman in the works of Edgar Degas\u2014also functions as a metaphor for the artistic process in this painting of a millinery shop. Degas has scraped and repainted the canvas around the woman's hands and the hat she holds to create a sense of movement. Nearby hats also remain unfinished\u2014awaiting their finishing touches in the shop, they are partially painted in broad strokes, as if Degas himself hasn't quite finished working on them.   The two girls depicted in this painting, clutching oranges tossed to them from the crowd as gifts, likely performed as acrobats in their father's famed Cirque Fernando, in Paris. Although they are painted standing in the center of a circus ring, Renoir actually painted them in his studio, where he could take full advantage of natural sunlight. Read more about this work on our blog .   Set in the Parisian suburb of Chatou, Two Sisters (On the Terrace) features a pair of young women who were not actually sisters. Pierre-Auguste Renoir juxtaposed the girls\u2019 solid, life-size figures against a dreamy, fantastic landscape. The basket of yarn to their left evokes the artist\u2019s palette, and the girls\u2019 contrasting expressions\u2014the elder\u2019s far-off stare and the younger\u2019s eager stillness\u2014make this \u201csisterly\u201d moment feel casually genuine.   There\u2019s a trick at work in this painting by \u00c9douard Manet of a woman sitting in a Parisian caf\u00e9\u2014the scene behind her is actually one of Manet\u2019s paintings, and the table, magazine, and other objects are props set up in Manet\u2019s studio. This highly Impressionistic painting, with its free brushstrokes and light colors, is typical of Manet\u2019s later works.   This scene of the Grande Jatte, an island in the Seine just outside of Paris where city residents sought rest and recreation, is considered Georges Seurat's greatest work. Seurat labored extensively over A Sunday on La Grande Jatte\u20141884 , reworking the original and completing numerous preliminary drawings and oil sketches . Inspired by research in optical and color theory, he juxtaposed tiny dabs of colors that, through optical blending, form a single and, he believed, more brilliantly luminous hue.   In 1888, Vincent van Gogh moved into a new house in Arles, France which he dubbed the \"Studio of the South\" in the hope that friends and artists would join him there. He immediately set to work on the house and painted this bedroom scene as a part of his decorating scheme. This sun-drenched composition with its vivid palette, dramatic perspective, and dynamic brushwork seems ready to burst with an intense, nervous vitality. Van Gogh liked this image so much that he painted three distinct versions\u2014the other two are held in the collections of the Van Gogh Museum in Amsterdam and the Mus\u00e9e d'Orsay in Paris. ",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search selections data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 19,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/3",
            "id": 3,
            "title": "what-to-see-in-an-hour",
            "timestamp": "2020-09-15T06:21:20-05:00"
        },
        {
            "_score": 1,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/4",
            "id": 4,
            "title": "new-acquisitions",
            "timestamp": "2020-09-15T06:21:20-05:00"
        },
        {
            "_score": 1,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/5",
            "id": 5,
            "title": "impressionism",
            "timestamp": "2020-09-15T06:21:20-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-rc16"
    }
}
# GET /selections/{id}

A single selection by the given identifier.

Example request: https://api.artic.edu/api/v1/selections/6
{
    "data": {
        "id": 6,
        "api_model": "selections",
        "api_link": "https://api.artic.edu/api/v1/selections/6",
        "title": "american-art",
        "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>",
        "copy": " Please note: artworks occasionally go off view for imaging, treatment, or loan to other institutions. Click on the images to ensure the work is currently on view.   Georgia O\u2019Keeffe didn't travel in an airplane until she was in her 70s, but when she did, she was fascinated. She started a series of paintings inspired by her in-flight experiences. The works began small and progressively got bigger until the final canvas in the series, Sky above Clouds IV , which is so large that it has never traveled since coming to the Art Institute.   One of America's most famous paintings, American Gothic , debuted at the Art Institute of Chicago, winning a $300 prize and instant fame for Grant Wood. It has long been parodied and is often seen as a satirical commentary on the Midwestern character, but Wood intended it to a positive statement about rural American values. Read more about this work on our blog, where a curator answers the top five FAQs about the iconic painting.   One of the best-known images of 20th-century art, Nighthawks depicts an all-night diner in which three customers, all lost in their own thoughts, have congregated. It's unclear how or why the anonymous and uncommunicative night owls are there\u2014in fact, Hopper eliminated any reference to an entrance to the diner. The four seem as separate and remote from the viewer as they are from one another. (The red-haired woman was actually modeled by the artist\u2019s wife, Jo.)   Known today for his paintings and murals depicting Mexican political and cultural life, Diego Rivera enjoyed a brief but sparkling period as a Cubist painter early in his career. In this work he portrayed his then-lover, the Russian-born painter and writer Marevna Vorob\u00ebv-Stebelska, clearly conveying her distinctive bobbed hair, blond bangs, and prominent nose\u2014despite or with the aid of the Cubist style. Like many other artists in Paris, Rivera rejected Cubism as frivolous and inappropriate following World War I and the Russian Revolution.   A native Chicagoan and graduate of the School of the Art Institute, Archibald Motley used his art to represent the vibrancy of African American culture, frequently portraying young, sophisticated city dwellers out on the town. One of Motley\u2019s most celebrated paintings, Nightlife depicts a crowded cabaret in the South Side neighborhood of Bronzeville. The dynamic composition, intense lighting, and heightened colors vividly express the liveliness of the scene.   The only American artist invited to exhibit with the French Impressionists, Mary Cassatt concentrated on the human figure, particularly on sensitive yet unsentimental portrayals of women and children. In The Child\u2019s Bath , one of Cassatt\u2019s masterworks, she used cropped forms, bold patterns and outlines, and a flattened perspective, all of which she derived from her study of Japanese woodblock prints.   Eldzier Cortor lived in Chicago and attended the School of the Art Institute, and while drawn to abstraction, he felt that it was not an effective tool for conveying serious social and political concerns. In The Room No. VI, the artist exposes the impoverished living conditions experienced by many African Americans on the South Side through a brilliant use of line and color, reinvigorating the idiom of social realism.   Though Stuart Davis studied with the so-called Ashcan School, who sought to depict a realistic look at modern urban life, he came to embrace a more abstracted and energetic style, as seen in Ready-to-Wear . The bright colors intersect and interrupt one another in a distinctly American way: jazzy, vital, and mass produced\u2014all qualities summed up in the title.   In addition to architecture, Frank Lloyd Wright designed furniture like this chair from his home in Oak Park, Illinois. Though his early experiments were heavy, solid cube chairs, he eventually added the refinements seen in this design, such as spindles, the subtly tapering crest rail, and gently curving leg ends, all of which produce an effect that is equal parts sophistication and simplicity.   In The Herring Net, Winslow Homer depicts two fishermen at their daily yet heroic work. As the small boat rides the swells, one fisherman hauls in the heavy net while the other unloads the glistening herring, illustrating that teamwork is essential for survival on this churning sea that both gives and takes. ",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/web-artists?limit=2
{
    "pagination": {
        "total": 105,
        "limit": 2,
        "offset": 0,
        "total_pages": 53,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/web-artists?page=2&limit=2"
    },
    "data": [
        {
            "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,
            ...
        },
        {
            "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": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search web-artists data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 114,
        "limit": 10,
        "offset": 0,
        "total_pages": 12,
        "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": "2020-09-15T06:21:20-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": "2020-09-15T06:21:20-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": "2020-09-15T06:21:20-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-rc16"
    }
}
# GET /web-artists/{id}

A single web-artist by the given identifier.

Example request: https://api.artic.edu/api/v1/web-artists/2
{
    "data": {
        "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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - 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",
            "last_updated_source": null,
            ...
        },
        {
            "id": 8,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/8",
            "title": "Digital Publications",
            "web_url": "/digital-publications",
            "last_updated_source": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search static-pages data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 1,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/1",
            "id": 1,
            "title": "Visit",
            "timestamp": "2020-09-15T14:10:11-05:00"
        },
        {
            "_score": 1,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/2",
            "id": 2,
            "title": "Events",
            "timestamp": "2020-09-15T14:10:11-05:00"
        },
        {
            "_score": 1,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/3",
            "id": 3,
            "title": "Exhibitions",
            "timestamp": "2020-09-15T14:10:11-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-rc16"
    }
}
# GET /static-pages/{id}

A single static-page by the given identifier.

Example request: https://api.artic.edu/api/v1/static-pages/11
{
    "data": {
        "id": 11,
        "api_model": "static-pages",
        "api_link": "https://api.artic.edu/api/v1/static-pages/11",
        "title": "Articles",
        "web_url": "/articles",
        "last_updated_source": 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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/generic-pages?limit=2
{
    "pagination": {
        "total": 206,
        "limit": 2,
        "offset": 0,
        "total_pages": 103,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/generic-pages?page=2&limit=2"
    },
    "data": [
        {
            "id": 417,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/417",
            "title": "Instagram",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/instagram",
            ...
        },
        {
            "id": 10,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/10",
            "title": "JourneyMaker",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/visit/explore-on-your-own/journeymaker",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search generic-pages data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 250,
        "limit": 10,
        "offset": 0,
        "total_pages": 25,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/1",
            "id": 1,
            "title": "Visit",
            "timestamp": "2020-09-15T06:21:20-05:00"
        },
        {
            "_score": 1,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/2",
            "id": 2,
            "title": "Free Admission Opportunities",
            "timestamp": "2020-09-15T06:21:20-05:00"
        },
        {
            "_score": 1,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/4",
            "id": 4,
            "title": "Directions & Parking",
            "timestamp": "2020-09-15T06:21:20-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-rc16"
    }
}
# GET /generic-pages/{id}

A single generic-page by the given identifier.

Example request: https://api.artic.edu/api/v1/generic-pages/417
{
    "data": {
        "id": 417,
        "api_model": "generic-pages",
        "api_link": "https://api.artic.edu/api/v1/generic-pages/417",
        "title": "Instagram",
        "type": null,
        "web_url": "https://nocache.www.artic.edu/instagram",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/press-releases?limit=2
{
    "pagination": {
        "total": 244,
        "limit": 2,
        "offset": 0,
        "total_pages": 122,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/press-releases?page=2&limit=2"
    },
    "data": [
        {
            "id": 16,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/16",
            "title": "Press Releases from 1954",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/press/press-releases/16/press-releases-from-1954",
            ...
        },
        {
            "id": 17,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/17",
            "title": "Press Releases from 1955",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/press/press-releases/17/press-releases-from-1955",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search press-releases data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 261,
        "limit": 10,
        "offset": 0,
        "total_pages": 27,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/1",
            "id": 1,
            "title": "Press Releases from 1939",
            "timestamp": "2020-09-15T06:21:22-05:00"
        },
        {
            "_score": 1,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/2",
            "id": 2,
            "title": "Press Releases from 1940",
            "timestamp": "2020-09-15T06:21:22-05:00"
        },
        {
            "_score": 1,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/3",
            "id": 3,
            "title": "Press Releases from 1941",
            "timestamp": "2020-09-15T06:21: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-rc16"
    }
}
# GET /press-releases/{id}

A single press-release by the given identifier.

Example request: https://api.artic.edu/api/v1/press-releases/16
{
    "data": {
        "id": 16,
        "api_model": "press-releases",
        "api_link": "https://api.artic.edu/api/v1/press-releases/16",
        "title": "Press Releases from 1954",
        "type": null,
        "web_url": "https://nocache.www.artic.edu/press/press-releases/16/press-releases-from-1954",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/educator-resources?limit=2
{
    "pagination": {
        "total": 56,
        "limit": 2,
        "offset": 0,
        "total_pages": 28,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/educator-resources?page=2&limit=2"
    },
    "data": [
        {
            "id": 63,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/63",
            "title": "Tips for Teachers and Parents: Body Language: How to Talk to Students About Nudity in Art",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/collection/resources/educator-resources/63-tips-for-teachers-and-parents-body-language-how-to-talk-to-students-about-nudity-in-art",
            ...
        },
        {
            "id": 17,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/17",
            "title": "Educator Resource Packet: City Landscape by Joan Mitchell",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/collection/resources/educator-resources/17-educator-resource-packet-city-landscape-by-joan-mitchell",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search educator-resources data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 108,
        "limit": 10,
        "offset": 0,
        "total_pages": 11,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/2",
            "id": 2,
            "title": "Test Resource",
            "timestamp": "2020-09-15T06:21:23-05:00"
        },
        {
            "_score": 1,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/3",
            "id": 3,
            "title": "Activity: Arrival of the Normandy Train, Gare Saint-Lazare",
            "timestamp": "2020-09-15T06:21:23-05:00"
        },
        {
            "_score": 1,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/4",
            "id": 4,
            "title": "Activity: The Family Concert",
            "timestamp": "2020-09-15T06:21:23-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-rc16"
    }
}
# GET /educator-resources/{id}

A single educator-resource by the given identifier.

Example request: https://api.artic.edu/api/v1/educator-resources/63
{
    "data": {
        "id": 63,
        "api_model": "educator-resources",
        "api_link": "https://api.artic.edu/api/v1/educator-resources/63",
        "title": "Tips for Teachers and Parents: Body Language: How to Talk to Students About Nudity in Art",
        "type": null,
        "web_url": "https://nocache.www.artic.edu/collection/resources/educator-resources/63-tips-for-teachers-and-parents-body-language-how-to-talk-to-students-about-nudity-in-art",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/digital-catalogs?limit=2
{
    "pagination": {
        "total": 13,
        "limit": 2,
        "offset": 0,
        "total_pages": 7,
        "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",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/digital-publications/american-silver",
            ...
        },
        {
            "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",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/digital-publications/roman-art-at-the-art-institute-of-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.0"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search digital-catalogs data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 14,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
            "id": 2,
            "title": "American Silver",
            "timestamp": "2020-09-15T06:21:23-05:00"
        },
        {
            "_score": 1,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/3",
            "id": 3,
            "title": "Modern Series: Go",
            "timestamp": "2020-09-15T06:21:23-05:00"
        },
        {
            "_score": 1,
            "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": "2020-09-15T06:21:23-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-rc16"
    }
}
# 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",
        "type": null,
        "web_url": "https://nocache.www.artic.edu/digital-publications/american-silver",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/printed-catalogs?limit=2
{
    "pagination": {
        "total": 115,
        "limit": 2,
        "offset": 0,
        "total_pages": 58,
        "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",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/print-publications/2001-building-for-space-travel",
            ...
        },
        {
            "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",
            "type": null,
            "web_url": "https://nocache.www.artic.edu/print-publications/1945-creativity-and-crisis-chicago-architecture-and-design-of-the-world-war-ii-era",
            ...
        }
    ],
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "website_url": "https://www.artic.edu"
    }
}

Search printed-catalogs data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - 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": 183,
        "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": "2020-09-15T06:21:23-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": "2020-09-15T06:21:23-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": "2020-09-15T06:21:23-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-rc16"
    }
}
# GET /printed-catalogs/{id}

A single printed-catalog by the given identifier.

Example request: https://api.artic.edu/api/v1/printed-catalogs/41
{
    "data": {
        "id": 41,
        "api_model": "printed-catalogs",
        "api_link": "https://api.artic.edu/api/v1/printed-catalogs/41",
        "title": "2001: Building for Space Travel",
        "type": null,
        "web_url": "https://nocache.www.artic.edu/print-publications/2001-building-for-space-travel",
        ...
    },
    "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"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "shop_image_url": "https://shop-images.imgix.net",
        "shop_product_url": "http://shop.artic.edu/item.aspx?productId=",
        "shop_category_url": "http://shop.artic.edu/item.aspx?productId=",
        "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 endpoint
  • api_link string - REST API link for this resource
  • is_boosted boolean - Whether this document should be boosted in search
  • title string - The name of this resource
  • alt_titles array - Alternate names for this work
  • thumbnail array - Thumbnail for showing this entity in search results. Currently, all thumbnails are IIIF images, but this may change in the future, so check type before proceeding.
  • main_reference_number string - Unique identifier assigned to the artwork upon acquisition
  • has_not_been_viewed_much boolean - Whether the artwork hasn't been visited on our website very much
  • boost_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 work
  • date_end number - The year of the period of time associated with the creation of this work
  • date_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 dates
  • place_of_origin string - The location where the creation, design, or production of the work took place, or the original location of the work
  • description string - Longer explanation describing the work
  • dimensions 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 work
  • inscriptions string - A description of distinguishing or identifying physical markings that are on the work
  • credit_line string - Brief statement indicating how the work came into the collection
  • publication_history string - Bibliographic list of all the places this work has been published
  • exhibition_history string - List of all the places this work has been exhibited
  • provenance_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 term
  • is_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 multimedia
  • has_educational_resources boolean - Whether this artwork has any documents tagged as educational
  • colorfulness float - Unbounded positive float representing an abstract measure of colorfulness.
  • color object - Dominant color of this artwork in HSL
  • latitude number - Latitude coordinate of the location of this work in our galleries
  • longitude number - Longitude coordinate of the location of this work in our galleries
  • latlon string - Latitude and longitude coordinates of the location of this work in our galleries
  • is_on_view boolean - Whether the work is on display
  • gallery_title string - The location of this work in our museum
  • gallery_id number - Unique identifier of the location of this work in our museum
  • artwork_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 work
  • department_title string - Name of the curatorial department that this work belongs to
  • department_id number - Unique identifier of the curatorial department that this work belongs to
  • artist_id integer - Unique identifier of the preferred artist/culture associated with this work
  • artist_title string - Name of the preferred artist/culture associated with this work
  • alt_artist_ids array - Unique identifiers of the non-preferred artists/cultures associated with this work
  • artist_ids integer - Unique identifier of all artist/cultures associated with this work
  • artist_titles array - Names of all artist/cultures associated with this work
  • category_ids array - Unique identifiers of the categories this work is a part of
  • category_titles array - Names of the categories this artwork is a part of
  • artwork_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, see publication_history.
  • term_titles array - The names of the taxonomy tags for this work
  • style_id string - Unique identifier of the preferred style term for this work
  • style_title string - The name of the preferred style term for this work
  • alt_style_ids array - Unique identifiers of all other non-preferred style terms for this work
  • style_ids array - Unique identifiers of all style terms for this work
  • style_titles array - The names of all style terms related to this artwork
  • classification_id string - Unique identifier of the preferred classification term for this work
  • classification_title string - The name of the preferred classification term for this work
  • alt_classification_ids array - Unique identifiers of all other non-preferred classification terms for this work
  • classification_ids array - Unique identifiers of all classification terms for this work
  • classification_titles array - The names of all classification terms related to this artwork
  • subject_id string - Unique identifier of the preferred subject term for this work
  • alt_subject_ids array - Unique identifiers of all other non-preferred subject terms for this work
  • subject_ids array - Unique identifiers of all subject terms for this work
  • subject_titles array - The names of all subject terms related to this artwork
  • material_id string - Unique identifier of the preferred material term for this work
  • alt_material_ids array - Unique identifiers of all other non-preferred material terms for this work
  • material_ids array - Unique identifiers of all material terms for this work
  • material_titles array - The names of all material terms related to this artwork
  • technique_id string - Unique identifier of the preferred technique term for this work
  • alt_technique_ids array - Unique identifiers of all other non-preferred technique terms for this work
  • technique_ids array - Unique identifiers of all technique terms for this work
  • technique_titles array - The names of all technique terms related to this artwork
  • theme_titles array - The names of all thematic publish categories related to this artwork
  • image_id uuid - Unique identifier of the preferred image to use to represent this work
  • alt_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 artwork
  • sound_ids uuid - Unique identifiers of the audio about this work
  • video_ids uuid - Unique identifiers of the videos about this work
  • text_ids uuid - Unique identifiers of the texts about this work
  • section_ids array - Unique identifiers of the digital publication chapters this work in included in
  • section_titles array - Names of the digital publication chapters this work is included in
  • site_ids array - Unique identifiers of the microsites this work is a part of
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • sort_title string - Sortable name for this agent, typically with last name first.
  • alt_titles array - Alternate names for this agent
  • birth_date number - The year this agent was born
  • birth_place string - Name of the place this agent was born
  • death_date number - The year this agent died
  • death_place string - Name of the place this agent died
  • description string - A biographical description of the agent
  • is_licensing_restricted boolean - Whether the use of the images of works by this artist are restricted by licensing
  • is_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 of
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: AIC Gallery, AIC Storage, No location
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: AIC Gallery, AIC Storage, No location
  • is_closed boolean - Whether the gallery is currently closed
  • number 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 LL
  • latitude number - Latitude coordinate of the center of the room
  • longitude number - Longitude coordinate of the center of the room
  • latlon string - Latitude and longitude coordinates of the center of the room
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • is_featured boolean - Is this exhibition currently featured on our website?
  • description string - Explanation of what this exhibition is
  • short_description string - Brief explanation of what this exhibition is
  • web_url string - URL to this exhibition on our website
  • image_url string - URL to the hero image from the website
  • type 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 closed
  • aic_start_at ISO 8601 date and time - Date the exhibition opened at the Art Institute of Chicago
  • aic_end_at ISO 8601 date and time - Date the exhibition closed at the Art Institute of Chicago
  • date_display string - A human-friendly string describing when this exhibition was open
  • department_display string - The name of the department that primarily organized the exhibition
  • gallery_id number - Unique identifier of the gallery that mainly housed the exhibition
  • gallery_title string - The name of the gallery that mainly housed the exhibition
  • artwork_ids array - Unique identifiers of the artworks that were part of the exhibition
  • artwork_titles array - Names of the artworks that were part of the exhibition
  • artist_ids array - Unique identifiers of the artist agent records representing who was shown in the exhibition
  • site_ids array - Unique identifiers of the microsites this exhibition is a part of
  • image_id uuid - Unique identifier of the preferred image to use to represent this exhibition
  • alt_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 exhibition
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • subtype string - Takes one of the following values: classification, material, technique, style, subject, department, theme
  • parent_id string - Unique identifier of this category's parent
  • 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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Assets

A binary 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_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 data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • iiif_url url - IIIF URL of this image
  • width number - Native width of the image
  • height number - Native height of the image
  • lqip 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 HSL
  • fingerprint object - Image hashes: aHash, dHash, pHash, wHash
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_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 data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_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 data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_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 data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_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 data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Shop

# Shop Categories

Tag-like classifications of shop products. 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url url - URL to the shop page for this category
  • parent_id number - Unique identifier of this category's parent
  • parent_title string - Name of this category's parent
  • child_ids array - Unique identifiers of this category's children
  • child_titles array - Names of this category's children
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • title_sort string - The sortable version of the name of this product
  • parent_id number - Unique identifier of this product's parent
  • category_id number - Identifier of this product's category
  • external_sku string - Numeric product identification code of a machine-readable barcode, when the customer sku differs from our internal one
  • image_url url - URL of an image for this product
  • web_url url - URL of this product in the shop
  • description string - Explanation of what this product is
  • price number - Number indicating how much the product costs the customer
  • aic_collection boolean - Whether the item is an AIC product
  • gift_box boolean - Whether the item can be wrapped in a gift box
  • holiday boolean - Whether the product is a holiday item
  • architecture boolean - Whether the product is an architectural item
  • glass boolean - Whether the item is glass
  • artist_ids array - Unique identifiers of the artists represented in this item
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • image url - The main image for the tour
  • description string - Explanation of what the tour is
  • intro string - Text introducing the tour
  • weight number - Number representing this tour's sort order
  • intro_link url - Link to the audio file of the introduction
  • intro_transcript string - Transcript of the introduction audio to the tour
  • artwork_titles array - Names of the artworks featured in this tour's tour stops
  • artist_titles array - Names of the artists of the artworks featured in this tour's tour stops
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - Name of this mobile audio file – derived from the artwork and tour titles
  • web_url url - URL to the audio file
  • transcript string - Text transcription of the audio file
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url string - URL to the publication
  • site string - Which site in our multi-site Drupal installation owns this publication
  • alias string - Used by Drupal in lieu of the id to generate pretty paths
  • section_ids array - Unique identifiers of the sections of this publication
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url string - URL to the section
  • accession string - An accession number parsed from the title or tombstone
  • revision number - Version identifier as provided by Drupal
  • source_id number - Drupal node id, unique only within the site of this publication
  • weight number - Number representing this section's sort order
  • generic_page_id number - Unique identifier of the page on the website that represents the publication this section belongs to
  • artwork_id number - Unique identifier of the artwork with which this section is associated
  • parent_id number - Uniquer identifier of the parent section
  • publication_title string - Name of the publication this section belongs to
  • publication_id number - Unique identifier of the publication this section belongs to
  • content string - Content of this section in plaintext
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • description string - Explanation of what this site is
  • web_url url - URL to this site
  • exhibition_ids array - Unique identifier of the exhibitions this site is associated with
  • exhibition_titles array - Names of the exhibitions this site is associated with
  • artist_ids array - Unique identifiers of the artists this site is associated with
  • artist_titles array - Names of the artists this site is associated with
  • artwork_ids array - Unique identifiers of the artworks this site is associated with
  • artwork_titles array - Names of the artworks this site is associated with
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • date_start ISO 8601 date and time - The date the closure begins
  • date_end ISO 8601 date and time - The date the closure ends
  • closure_copy string - Description of the closure
  • type number - Number indicating the type of closure
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • exhibition_id number - Identifier of the CITI exhibition this website exhibition is tied to
  • is_featured boolean - Is this exhibition currently featured on our website?
  • header_copy string - The text at the top of the exhibition page
  • list_description string - Short description to be used for exhibition listings
  • exhibition_message string - Pricing or attendance information
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • title_display string - The name of this event formatted with HTML (optional)
  • image_url string - The URL of an image representing this page
  • hero_caption string - Text displayed with the hero image on the event
  • short_description string - Brief description of the event
  • header_description string - Brief description of the event displayed below the title
  • list_description string - One-sentence description of the event displayed in listings
  • description string - All copytext of the event
  • location string - Where the event takes place
  • event_type_id number - Unique identifier indicating the preferred type of this event
  • alt_event_type_ids array - Unique identifiers indicating the alternate types of this event
  • audience_id number - Unique identifier indicating the preferred audience for this event
  • alt_audience_ids array - Unique identifiers indicating the alternate audiences for this event
  • program_ids array - Unique identifiers indicating the programs this event is a part of
  • program_titles array - Titles of the programs this event is a part of
  • is_ticketed boolean - Whether a ticket is required to attend the event
  • rsvp_link url - The URL to the sales site for this event
  • buy_button_text string - The text used on the ticket/registration button
  • buy_button_caption string - Additional text below the ticket/registration button
  • is_registration_required boolean - Whether registration is required to attend the event
  • is_member_exclusive boolean - Whether the event is exclusive to members of the museum
  • is_sold_out boolean - Whether the event is sold out
  • is_free boolean - Whether the event is free
  • is_admission_required boolean - Whether admission to the museum is required to attend this event
  • is_after_hours boolean - Whether the event is to be held after the museum closes
  • start_date ISO 8601 date and time - The date the event begins
  • end_date ISO 8601 date and time - The date the event ends
  • start_time string - The time the event starts
  • end_time string - The time the event ends
  • date_display string - A readable display of the event dates
  • door_time string - The time the doors open for this event
  • layout_type number - Number indicating the type of layout this event page uses
  • slug string - A string used in the URL for this event
  • entrance string - Which entrance to use for this event
  • join_url string - URL to the membership signup page via this event
  • survey_url string - URL to the survey associated with this event
  • event_host_id number - Unique identifier of the host (cf. event programs) that is presenting this event
  • event_host_title string - Unique identifier of the host (cf. event programs) that is presenting this event
  • sponsor_id number - Unique identifier of the sponsor this website event is tied to
  • search_tags array - Editor-specified list of tags to aid in internal search
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • event_id integer - Identifier of the master event of which this is an occurrence
  • short_description string - Brief description of the event
  • description string - Description of the event
  • image_url string - The URL of an image representing this page
  • is_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 begins
  • end_at ISO 8601 date and time - The date the event occurrence ends
  • location string - Where the event takes place
  • button_url url - The URL to the sales site or an RSVP link for this event
  • button_text string - The text used on the ticket/registration button
  • button_caption string - Additional text below the ticket/registration button
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • is_affiliate_group boolean - Whether this program represents an affiliate group
  • is_event_host boolean - Whether this program represents an event host
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • date ISO 8601 date and time - The date the article was published
  • copy string - The text of the article
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • short_copy string - A brief summary of what is contained in the selection
  • copy string - The text of the selection description
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • has_also_known_as boolean - Whether the artist will display multiple names
  • intro_copy string - Description of the artist
  • agent_id number - Unique identifier of the CITI agent records this artist represents
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url string - The URL to this page on our website
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • search_tags array - Editor-specified list of tags to aid in internal search
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp 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 endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_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 system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index