Art Institute of Chicago Artwork Search (Paintings, Prints, Photographs and More)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "What to find, matched against every indexed field of the record (title, artist, subjects, style, medium, place) with AND between words, for example monet water lilies. Quote a phrase (\"water lilies\"), prefix a word with - to exclude it, put | between alternatives, end a word with * for a prefix. A lone * matches every record, for listing one artist's works with artist_id."
    },
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1,
      "description": "Which page of results, 1 to 10. The museum's search stops at the first 1,000 hits, so page 10 at limit 100 is the last reachable page; narrow the query to go deeper."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "How many artworks per page, 1 to 100."
    },
    "artist_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Only works attributed to this artist: the id from Art Institute of Chicago Artist Search, for example 35809 for Claude Monet."
    },
    "is_public_domain": {
      "type": "boolean",
      "description": "true keeps only works the museum flags public domain; false keeps only works it does not flag (which is not the same as under copyright). Leave it out for both."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "description": "The museum's artwork id. Pass it to Art Institute of Chicago Artwork Details."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The artwork's title (null on 1 record in the catalogue)."
          },
          "_score": {
            "type": "number",
            "description": "Search relevance: orders this response only, and carries no meaning when the query is a lone *."
          },
          "date_end": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Latest year, negative for BCE. Wider than date_display for an approximate date, null on about 4% of records, and a handful over 2026 are source typos."
          },
          "artist_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "The artist's id for Artist Search. Null when the work is unattributed."
          },
          "date_start": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Earliest year, negative for BCE (-330 is 330 BCE). Wider than date_display for an approximate date; null on about 4% of records."
          },
          "is_on_view": {
            "type": "boolean",
            "description": "True when the work is on display in the museum now."
          },
          "artist_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The attribution as the museum words it: a person, a culture such as Ancient Greek, or a qualified name. Null when unattributed."
          },
          "date_display": {
            "type": [
              "string",
              "null"
            ],
            "description": "The date as the museum writes it: 1906, 1830/33, c. 1395, about 510-500 BCE, or n.d. This is the date to quote. Null on 0.3% of records."
          },
          "gallery_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The gallery, for example Gallery 243, when the work is on view; otherwise null."
          },
          "medium_display": {
            "type": [
              "string",
              "null"
            ],
            "description": "Materials and technique, for example Oil on canvas."
          },
          "place_of_origin": {
            "type": [
              "string",
              "null"
            ],
            "description": "Where the work was made, as the museum records it. Null when unrecorded."
          },
          "department_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The museum department that holds the work."
          },
          "is_public_domain": {
            "type": "boolean",
            "description": "The museum's public-domain flag. False means not designated public domain, not that the work is under copyright."
          },
          "artwork_type_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Object type: Painting, Print, Photograph, Textile, Sculpture, and so on."
          },
          "main_reference_number": {
            "type": "string",
            "description": "The museum's accession number, for example 1933.1157."
          }
        },
        "additionalProperties": true
      },
      "description": "The matching artworks on this page, best match first. Empty when none match."
    },
    "info": {
      "type": "object",
      "description": "The museum's licence_text, license_links and API version for this response.",
      "additionalProperties": true
    },
    "pagination": {
      "type": "object",
      "description": "total is the number of matching records (0 when none), limit and offset as applied, and total_pages and current_page for the page asked for.",
      "additionalProperties": true
    }
  },
  "description": "The museum's response: pagination (total match count, limit, offset, total_pages, current_page), the matching artworks in data best first, an info block carrying the licence text and links, and a config block of site base URLs.",
  "additionalProperties": true
}