Art Institute of Chicago
The Art Institute of Chicago publishes an open, REST + Elasticsearch-style Public API for ~120,000 artworks plus agents (artists/makers), places, galleries, exhibitions, tours, mobile sounds, museum-shop products, publications, sections, sites, educator resources, digital and printed publications, and static archive images. Most data is CC0 1.0; descriptions and place data are CC-BY 4.0. No API key required; anonymous limit is 60 requests/minute per IP. Clients should send an AIC-User-Agent header for courtesy tracking. The canonical aggregator (Laravel) is open source on GitHub, and nightly bulk data dumps are published in a sibling repo.
3 APIs
0 Features
Art And DesignMuseumOpen DataCultural HeritageIIIFPublic APIsOpen Source
opencollection: 1.0.0
info:
name: Art Institute of Chicago Public API
version: '1.14'
items:
- info:
name: Artworks
type: folder
items:
- info:
name: List Artworks
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artworks
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all artworks sorted by last updated date in descending order.
- info:
name: Search Artworks
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artworks/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: Search artworks data in the aggregator. Artworks in the groups of essentials are boosted so they'll show up higher
in results.
- info:
name: Get Artwork
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artworks/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single artwork by ID.
- info:
name: Agents
type: folder
items:
- info:
name: List Agents
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agents
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all agents sorted by last updated date in descending order.
- info:
name: Search Agents
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agents/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search agents data in the aggregator. '
- info:
name: Get Agent
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agents/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single agent by ID.
- info:
name: Artists
type: folder
items:
- info:
name: List Artists
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artists
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all artists sorted by last updated date in descending order.
- info:
name: Get Artist
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artists/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single artist by ID.
- info:
name: Places
type: folder
items:
- info:
name: List Places
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/places
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all places sorted by last updated date in descending order.
- info:
name: Search Places
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/places/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search places data in the aggregator. '
- info:
name: Get Place
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/places/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single place by ID.
- info:
name: Galleries
type: folder
items:
- info:
name: List Galleries
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/galleries
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all galleries sorted by last updated date in descending order.
- info:
name: Search Galleries
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/galleries/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search galleries data in the aggregator. '
- info:
name: Get Gallery
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/galleries/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single gallery by ID.
- info:
name: Exhibitions
type: folder
items:
- info:
name: List Exhibitions
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/exhibitions
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all exhibitions sorted by last updated date in descending order.
- info:
name: Search Exhibitions
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/exhibitions/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search exhibitions data in the aggregator. '
- info:
name: Get Exhibition
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/exhibitions/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single exhibition by ID.
- info:
name: Agent Types
type: folder
items:
- info:
name: List Agent Types
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agent-types
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all agent-types sorted by last updated date in descending order.
- info:
name: Get Agent Type
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agent-types/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single agent type by ID.
- info:
name: Agent Roles
type: folder
items:
- info:
name: List Agent Roles
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agent-roles
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all agent-roles sorted by last updated date in descending order.
- info:
name: Get Agent Role
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/agent-roles/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single agent role by ID.
- info:
name: Artwork Place Qualifiers
type: folder
items:
- info:
name: List Artwork Place Qualifiers
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artwork-place-qualifiers
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all artwork-place-qualifiers sorted by last updated date in descending order.
- info:
name: Get Artwork Place Qualifier
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artwork-place-qualifiers/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single artwork place qualifier by ID.
- info:
name: Artwork Date Qualifiers
type: folder
items:
- info:
name: List Artwork Date Qualifiers
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artwork-date-qualifiers
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all artwork-date-qualifiers sorted by last updated date in descending order.
- info:
name: Get Artwork Date Qualifier
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artwork-date-qualifiers/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single artwork date qualifier by ID.
- info:
name: Artwork Types
type: folder
items:
- info:
name: List Artwork Types
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artwork-types
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all artwork-types sorted by last updated date in descending order.
- info:
name: Get Artwork Type
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/artwork-types/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single artwork type by ID.
- info:
name: Category Terms
type: folder
items:
- info:
name: List Category Terms
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/category-terms
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all category-terms sorted by last updated date in descending order.
- info:
name: Search Category Terms
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/category-terms/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search category-terms data in the aggregator. '
- info:
name: Get Category Term
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/category-terms/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single category term by ID.
- info:
name: Images
type: folder
items:
- info:
name: List Images
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/images
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all images sorted by last updated date in descending order.
- info:
name: Search Images
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/images/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search images data in the aggregator. '
- info:
name: Get Image
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/images/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single image by ID.
- info:
name: Videos
type: folder
items:
- info:
name: List Videos
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/videos
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: A list of all videos sorted by last updated date in descending order.
- info:
name: Search Videos
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/videos/search
params:
- name: q
value: ''
type: query
description: Free-text search string.
- name: query
value: ''
type: query
description: Elasticsearch Query DSL JSON (URL-encoded).
- name: sort
value: ''
type: query
description: Sort specification (Elasticsearch sort syntax).
- name: from
value: ''
type: query
description: Elasticsearch offset pagination starting record.
- name: size
value: ''
type: query
description: Elasticsearch page size (max 100).
- name: facets
value: ''
type: query
description: Comma-separated list of fields to facet on for aggregations.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
docs: 'Search videos data in the aggregator. '
- info:
name: Get Video
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/videos/:id
params:
- name: id
value: ''
type: path
description: Numeric resource identifier.
- name: fields
value: ''
type: query
description: Comma-separated list of fields to include in the response (sparse fieldsets).
- name: include
value: ''
type: query
description: Comma-separated list of related resources to include (e.g. artist_pivots, dates, place_pivots, sites).
docs: Retrieve a single video by ID.
- info:
name: Sounds
type: folder
items:
- info:
name: List Sounds
type: http
http:
method: GET
url: https://api.artic.edu/api/v1/sounds
params:
- name: ids
value: ''
type: query
description: Comma-separated list of resource IDs to fetch in one call.
- name: limit
value: ''
type: query
description: Number of records to return per page (default 12, max 100).
- name: page
value: ''
type: query
description: Page number (1-based).
- name: fields
value: ''
type: query
description: Comma-separated list of field
# --- truncated at 32 KB (91 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/apis.yml