Art Institute of Chicago website screenshot

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

APIs

Art Institute of Chicago Public API

Open REST and search API surfacing the museum's collection, agents, exhibitions, tours, publications, products and operational data (galleries, hours, sites). Backed by Elastics...

IIIF Image API

IIIF Image API 2.0-compliant service for delivering image binaries for artworks. Combine artwork.image_id with config.iiif_url returned by the Public API.

Bulk Data Dumps

Nightly data dumps of the collection and related resources, published as JSON in a public GitHub repository. Recommended for bulk consumers instead of scraping the API.

Collections

Pricing Plans

Rate Limits

Semantic Vocabularies

Art Institute Of Chicago Context

29 classes · 4 properties

JSON-LD

API Governance Rules

Art Institute of Chicago API Rules

11 rules · 7 errors 4 warnings

SPECTRAL

JSON Structure

Art Institute Of Chicago Agent Structure

0 properties

JSON STRUCTURE

Art Institute Of Chicago Artwork Structure

0 properties

JSON STRUCTURE

Art Institute Of Chicago Exhibition Structure

0 properties

JSON STRUCTURE

Art Institute Of Chicago Gallery Structure

0 properties

JSON STRUCTURE

Art Institute Of Chicago Place Structure

0 properties

JSON STRUCTURE

Art Institute Of Chicago Product Structure

0 properties

JSON STRUCTURE

Art Institute Of Chicago Tour Structure

0 properties

JSON STRUCTURE

Example Payloads

Resources

🔗
Website
Website
🔗
Documentation
Documentation
🌐
Portal
Portal
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
💬
Support
Support
👥
GitHubOrganization
GitHubOrganization
👥
GitHubRepository
GitHubRepository
👥
GitHubRepository
GitHubRepository
👥
GitHubRepository
GitHubRepository
📦
SDKs
SDKs
🔧
Tools
Tools
🔧
Tools
Tools
🔧
Tools
Tools
🔧
Tools
Tools
🔧
Tools
Tools
🔧
Tools
Tools
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
PublicAPIsListing
PublicAPIsListing

Sources

Raw ↑
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