Search artworks
artic_search_artworksSearch the Art Institute of Chicago collection by text and structured filters, ranked by relevance or sorted by date or acquisition year. Text matches all words across titles, artists, descriptions, provenance, and other catalog fields; common English words such as the and of are ignored. Filters combine with AND. Results reach the first 1,000 matches; narrow with filters for more. Set limit to 0 with facets to get only counts. Use artic_lookup_vocabulary for filter values and artic_get_artworks for full records.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "artic_search_artworks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page to return (1-based); page times the applied limit may not exceed 1,000. | |
| sort | No | relevance ranks by query text, or by museum popularity without it. date_asc and date_desc sort by start year: works without one come last, and records with a placeholder start year (outside -8000 to 2100) are left out. acquired_desc (recent acquisitions first) and acquired_asc sort by acquisition fiscal year, with works that have no recorded fiscal year last. | relevance |
| limit | No | Requested rows per page (0-1,000); at most 100 are returned. 0 returns only totalCount and facets. | |
| query | No | Text matched against titles, artists, descriptions, provenance, and other catalog fields; every word must match, except common English words such as the and of, which are ignored. Supports "exact phrase", -exclude, and a | b. | |
| style | No | Style title as artic_lookup_vocabulary lists it (case ignored), such as Impressionism; matches preferred or alternate styles. | |
| theme | No | Theme title as artic_lookup_vocabulary lists it (case ignored), such as Women artists. | |
| artist | No | Artist or culture name matched against every credited artist (all words must match). | |
| facets | No | Facet counts to compute over the filtered set (top 15 values each), any or all of: department, artwork_type, style, subject, classification, material, technique, theme, place_of_origin, gallery, artist. An array or a comma-separated string. | |
| gallery | No | Gallery where the work is on view, such as Gallery 240 (a bare 240 is read as Gallery 240). Only on-view works carry a gallery. | |
| subject | No | Subject title as artic_lookup_vocabulary lists it (case ignored). | |
| year_to | No | Latest year; a work matches when its date span overlaps year_from to year_to. Negative for BCE. | |
| material | No | Material title as artic_lookup_vocabulary lists it (case ignored), such as ink or gold leaf. | |
| artist_id | No | Agent id from artic_search_artists or an artist facet row; matches preferred and other credits. | |
| has_image | No | Only works with an image. | |
| technique | No | Technique title as artic_lookup_vocabulary lists it (case ignored), such as black-and-white photography or plain weaving. | |
| year_from | No | Earliest year; a work matches when its date span overlaps year_from to year_to. Negative for BCE. | |
| department | No | Department title exactly as artic_lookup_vocabulary lists it (case ignored), such as Prints and Drawings. | |
| acquired_to | No | Latest fiscal year in which the museum acquired the work (acquisition_fiscal_year), inclusive. Works with no recorded acquisition year never match. | |
| artwork_type | No | Artwork type title as artic_lookup_vocabulary lists it (case ignored), such as Painting or Print. | |
| on_view_only | No | Only works on view at the museum now. | |
| acquired_from | No | Earliest fiscal year in which the museum acquired the work (acquisition_fiscal_year), inclusive. Works with no recorded acquisition year never match, so this filter alone never gives a complete provenance-review set. | |
| classification | No | Classification title as artic_lookup_vocabulary lists it (case ignored), such as oil on canvas or etching. | |
| place_of_origin | No | Place of origin as artic_lookup_vocabulary lists it (case ignored), such as france. | |
| public_domain_only | No | Only public-domain works, whose images are CC0. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied to this page. | |
| page | No | Page returned (1-based). | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Rows returned on this page. | |
| facets | No | Counts over the filtered set for each requested facet; present only when facets were requested. | |
| notice | No | Guidance when nothing matched, more pages exist, or the reachable window is exhausted. | |
| artworks | No | Matching artworks on this page, in ranked or sorted order. | |
| has_more | No | True when more matches exist beyond this page. | |
| next_page | No | Page to request next; absent when nothing remains or the next page would pass the first 1,000 matches. | |
| truncated | No | True when more matches exist beyond this page. | |
| totalCount | No | Matches for the query and filters, before paging. | |
| license_text | No | License statement from the API for this data, verbatim. | |
| sort_applied | No | Order applied; popularity when relevance was requested without query text (the museum popularity ranking). |