{"ok":true,"site":"artic","host":"artic.edu","about":"Art Institute of Chicago collection. The CLI queries the museum's official public JSON API (api.artic.edu) for artworks, artists, exhibitions, events, articles, category terms and IIIF manifests, and adds the website's related-artworks lookup.","commands":[{"command":"search-artworks","summary":"Full-text search of the collection's artworks, with optional filters (public domain, on view, department, artist id), sort by date and pagination","params":[{"name":"q","type":"string","description":"Keyword query (title, artist, subject…)"},{"name":"public_domain","type":"boolean","description":"Only public-domain artworks (images free to reuse)"},{"name":"on_view","type":"boolean","description":"Only artworks currently on view in the galleries"},{"name":"department","type":"string","description":"Exact department title, e.g. 'Painting and Sculpture of Europe', 'Arts of the Americas', 'Prints and Drawings'"},{"name":"artist_id","type":"number","description":"Restrict to one artist. Use the numeric id from search-artists."},{"name":"sort_date","type":"string","description":"Sort by start date instead of relevance","oneOf":["asc","desc"]},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,artist_title,artist_id,artist_display,date_display,medium_display,image_id,is_public_domain,is_on_view,department_title"},{"name":"api_limit","type":"number","description":"Results per page (max 100) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number (1-based)","default":1}],"exampleUrl":"https://clify-dev.netlify.app/artic/search-artworks?q=monet&public_domain=true&on_view=true&department=Arts+of+the+Americas&artist_id=34996"},{"command":"facet-artworks","summary":"Get facet counts (aggregation buckets) over the whole artwork collection for a keyword field such as department, classification or artist","params":[{"name":"field","type":"string","description":"Keyword field to bucket on, e.g. department_title.keyword, artist_title.keyword, classification_title.keyword, artwork_type_title.keyword, place_of_origin.keyword, style_title.keyword","default":"department_title.keyword"},{"name":"size","type":"number","description":"Number of buckets to return","default":20}],"exampleUrl":"https://clify-dev.netlify.app/artic/facet-artworks?field=department_title.keyword"},{"command":"get-artwork","summary":"Get full details of one artwork by numeric id (title, artist, date, medium, dimensions, credit line, gallery, description, image id)","params":[{"name":"id","type":"number","required":true,"description":"Artwork id, e.g. 111628 (Nighthawks)"},{"name":"api_fields","type":"string","description":"Optional comma-separated subset of fields to return (default: all) (sent to the site as \"fields\"; clify's own --fields only shapes the output)"}],"exampleUrl":"https://clify-dev.netlify.app/artic/get-artwork"},{"command":"get-artworks","summary":"Fetch several artworks at once by a comma-separated list of ids","params":[{"name":"ids","type":"string","required":true,"description":"Comma-separated artwork ids"},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,artist_title,date_display,medium_display,image_id,is_on_view,department_title"}],"exampleUrl":"https://clify-dev.netlify.app/artic/get-artworks?ids=28560%2C111628"},{"command":"get-artwork-manifest","summary":"Get the IIIF Presentation manifest for an artwork (image service URLs, label, metadata)","params":[{"name":"id","type":"number","required":true,"description":"Artwork id"}],"exampleUrl":"https://clify-dev.netlify.app/artic/get-artwork-manifest"},{"command":"search-artists","summary":"Search artists by name. The returned id works with get-artist and the artist_id filter of search-artworks.","params":[{"name":"q","type":"string","required":true,"description":"Artist name or keyword"},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,birth_date,death_date,alt_titles,description"},{"name":"api_limit","type":"number","description":"Results per page (max 100) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/artic/search-artists?q=hopper"},{"command":"get-artist","summary":"Get details of one artist by id (name, alternate names, birth and death dates, biography)","params":[{"name":"id","type":"number","required":true,"description":"Artist id, e.g. 34996 (Edward Hopper)"}],"exampleUrl":"https://clify-dev.netlify.app/artic/get-artist"},{"command":"search-exhibitions","summary":"Search museum exhibitions (current and past) by keyword","params":[{"name":"q","type":"string","description":"Keyword query"},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,status,aic_start_at,aic_end_at,web_url,image_url,short_description"},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/artic/search-exhibitions?q=cassatt"},{"command":"get-exhibition","summary":"Get details of one exhibition by id (dates, gallery, description, artworks shown)","params":[{"name":"id","type":"number","required":true,"description":"Exhibition id, e.g. 10487"}],"exampleUrl":"https://clify-dev.netlify.app/artic/get-exhibition"},{"command":"search-events","summary":"Search museum events (tours, talks, programs) by keyword","params":[{"name":"q","type":"string","description":"Keyword query (omit to list events)"},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,start_date,end_date,location,short_description,image_url"},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/artic/search-events?api_limit=5"},{"command":"search-articles","summary":"Search the museum's editorial articles by keyword","params":[{"name":"q","type":"string","description":"Keyword query"},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,copy,image_url,api_link"},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/artic/search-articles?q=nighthawks"},{"command":"search-category-terms","summary":"Search category terms (styles, subjects, themes, classifications, materials, techniques, departments)","params":[{"name":"q","type":"string","description":"Keyword query"},{"name":"subtype","type":"string","description":"Restrict to one kind of term","oneOf":["style","subject","theme","classification","material","technique","department"]},{"name":"api_fields","type":"string","description":"Comma-separated fields to return (sent to the site as \"fields\"; clify's own --fields only shapes the output)","default":"id,title,subtype,parent_id"},{"name":"api_limit","type":"number","description":"Results per page (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"page","type":"number","description":"Page number","default":1}],"exampleUrl":"https://clify-dev.netlify.app/artic/search-category-terms?q=impressionism"}]}