{ "openapi": "3.1.0", "info": { "title": "Artworks API", "version": "1.0.0", "description": "132,739 artworks from the Art Institute of Chicago with artist, medium, dates, flags and IIIF image URLs.\n\nA world-class museum collection as an API. All 132,739 artworks from the Art Institute of Chicago's open-access dataset (CC0) — Monet's Water Lilies, American Gothic, Nighthawks, Van Gogh's The Bedroom — each with artist, dates, medium, dimensions, department, classification, style, place of origin, credit line, gallery location, and public-domain / on-view flags. 122,626 artworks carry ready-to-embed IIIF image URLs at three sizes (200/843/1686 px) from the museum's own image server. Full-text search covers titles, artists and descriptive facets ('water lilies monet' finds exactly the right painting), with filters for department, artwork type, artist, year range, public-domain status and currently-on-view. Browse 62,054 public-domain works safe for any use, pull artist profiles with work counts (Picasso: 359), or hit the random endpoint — public-domain-with-image by default — for art-of-the-day features, wallpaper apps and screensavers. Education platforms, print-on-demand, content tools, art-quiz games: museum-grade art data at one token per call.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/artworks.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/artworks" }, "servers": [ { "url": "https://api-artworks.dataandapis.com" } ], "tags": [ { "name": "Entertainment", "description": "Artworks API belongs to the Entertainment category of the Data and APIs catalog." } ], "paths": { "/v1/artworks/artists": { "get": { "operationId": "artists", "summary": "Artists", "description": "Artists endpoint of the Artworks API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/artworks/artists" }, "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "picasso" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "artists": [ { "artist": "Pablo Picasso", "artist_full": "Pablo Picasso Spanish, 1881-1973", "artist_id": 36198, "artworks": 359, "with_images": 356 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/artworks/{id}": { "get": { "operationId": "artworkDetail", "summary": "Artwork Detail", "description": "Artwork Detail endpoint of the Artworks API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/artworks/artwork-detail" }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "example": "6565" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "artwork": { "id": 6565, "title": "American Gothic", "artist": "Grant Wood", "artist_full": "Grant Wood (American, 1891–1942)", "artist_id": 37343, "date_display": "1930", "date_start": 1930, "date_end": 1930, "medium": "Oil on Beaver Board", "dimensions": "78 × 65.3 cm (30 3/4 × 25 3/4 in.)", "department": "Arts of the Americas", "artwork_type": "Painting", "classification": "oil paintings (visual works)", "style": "Realism", "place_of_origin": "Cedar Rapids", "credit_line": "Friends of American Art Collection", "reference_number": "1930.934", "gallery": "Gallery 263", "is_public_domain": false, "is_on_view": true, "image_id": "b272df73-a965-ac37-4172-be4e99483637", "facets": "Realism oil paintings (visual works) Cedar Rapids Oil on Beaver Board", "images": { "thumbnail": "https://www.artic.edu/iiif/2/b272df73-a965-ac37-4172-be4e99483637/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/b272df73-a965-ac37-4172-be4e99483637/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/b272df73-a965-ac37-4172-be4e99483637/full/1686,/0/default.jpg" }, "artic_url": "https://www.artic.edu/artworks/6565" }, "more_by_artist": [ { "id": 228478, "title": "January", "date_display": "1938", "images": { "thumbnail": "https://www.artic.edu/iiif/2/0b54c226-da71-d825-636b-adbd77f0fa25/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/0b54c226-da71-d825-636b-adbd77f0fa25/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/0b54c226-da71-d825-636b-adbd77f0fa25/full/1686,/0/default.jpg" } }, { "id": 237322, "title": "Fruits", "date_display": "1939", "images": { "thumbnail": "https://www.artic.edu/iiif/2/394ff5d7-22a6-7347-0d3a-3548a3caee93/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/394ff5d7-22a6-7347-0d3a-3548a3caee93/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/394ff5d7-22a6-7347-0d3a-3548a3caee93/full/1686,/0/default.jpg" } }, { "id": 100820, "title": "July Fifteenth", "date_display": "1938", "images": { "thumbnail": "https://www.artic.edu/iiif/2/0ee36c58-4da5-fe04-b2fe-9a9aa8852496/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/0ee36c58-4da5-fe04-b2fe-9a9aa8852496/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/0ee36c58-4da5-fe04-b2fe-9a9aa8852496/full/1686,/0/default.jpg" } }, { "id": 117693, "title": "Fertility", "date_display": "1939", "images": { "thumbnail": "https://www.artic.edu/iiif/2/1798f46c-9597-bc0f-fdcf-08c5bd59cc87/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/1798f46c-9597-bc0f-fdcf-08c5bd59cc87/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/1798f46c-9597-bc0f-fdcf-08c5bd59cc87/full/1686,/0/default.jpg" } }, { "id": 100900, "title": "The Pump", "date_display": "1937", "images": { "thumbnail": "https://www.artic.edu/iiif/2/d8520607-d8de-4bb2-3c9e-25cc4f7926f0/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/d8520607-d8de-4bb2-3c9e-25cc4f7926f0/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/d8520607-d8de-4bb2-3c9e-25cc4f7926f0/full/1686,/0/default.jpg" } } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Artworks API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/artworks/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "sources": [ { "slug": "aic", "name": "Art Institute of Chicago open access", "publisher": "Art Institute of Chicago", "licence": "CC0 (data); images via AIC IIIF", "source_url": "https://www.artic.edu/open-access/public-api", "file_url": "https://api.artic.edu/api/v1/artworks", "cadence": "collection updates; occasional re-scrape", "record_count": 132739, "retrieved_at": "2026-09-06" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/artworks/departments": { "get": { "operationId": "departments", "summary": "Departments", "description": "Departments endpoint of the Artworks API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/artworks/departments" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "departments": [ { "department": "Prints and Drawings", "artworks": 53804, "with_images": 50443 }, { "department": "Photography and Media", "artworks": 24503, "with_images": 23118 }, { "department": "Arts of Asia", "artworks": 17023, "with_images": 14003 }, { "department": "Textiles", "artworks": 11737, "with_images": 11375 }, { "department": "Architecture and Design", "artworks": 6172, "with_images": 4990 }, { "department": "Applied Arts of Europe", "artworks": 5555, "with_images": 5542 }, { "department": "Arts of the Americas", "artworks": 4474, "with_images": 4231 }, { "department": "Painting and Sculpture of Europe", "artworks": 2402, "with_images": 2339 }, { "department": "Arts of Greece, Rome, and Byzantium", "artworks": 2196, "with_images": 2111 }, { "department": "Contemporary Art", "artworks": 1883, "with_images": 1660 }, { "department": "Arts of Africa", "artworks": 1683, "with_images": 1613 }, { "department": "Modern Art", "artworks": 470, "with_images": 464 }, { "department": "Ryerson and Burnham Libraries Special Collections", "artworks": 348, "with_images": 343 }, { "department": "AIC Archives", "artworks": 261, "with_images": 257 }, { "department": "Modern and Contemporary Art", "artworks": 4, "with_images": 3 } ], "artwork_types": [ { "type": "Print", "artworks": 48210 }, { "type": "Photograph", "artworks": 24757 }, { "type": "Drawing and Watercolor", "artworks": 15042 }, { "type": "Textile", "artworks": 9831 }, { "type": "Painting", "artworks": 3912 }, { "type": "Architectural Drawing", "artworks": 3550 }, { "type": "Book", "artworks": 3530 }, { "type": "Ceramics", "artworks": 3377 }, { "type": "Vessel", "artworks": 2558 }, { "type": "Costume and Accessories", "artworks": 2436 }, { "type": "Sculpture", "artworks": 2396 }, { "type": "Glass", "artworks": 2276 }, { "type": "Metalwork", "artworks": 1764 }, { "type": "Coin", "artworks": 1276 }, { "type": "Graphic Design", "artworks": 1201 }, { "type": "Religious/Ritual Object", "artworks": 993 }, { "type": "Design", "artworks": 789 }, { "type": "Medals", "artworks": 622 }, { "type": "Furniture", "artworks": 523 }, { "type": "Arms", "artworks": 518 }, { "type": "Decorative Arts", "artworks": 513 }, { "type": "Armor", "artworks": 345 }, { "type": "Architectural fragment", "artworks": 271 }, { "type": "Miniature Painting", "artworks": 268 }, { "type": "Archives (groupings)", "artworks": 230 }, { "type": "Mixed Media", "artworks": 197 }, { "type": "Model", "artworks": 193 }, { "type": "non-art", "artworks": 173 }, { "type": "Film, Video, New Media", "artworks": 167 }, { "type": "Coverings and Hangings", "artworks": 160 } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/artworks/random": { "get": { "operationId": "randomArtwork", "summary": "Random Artwork", "description": "Random Artwork endpoint of the Artworks API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/artworks/random-artwork" }, "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "example": "Painting" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "artwork": { "id": 16473, "title": "Cigar Making in Seville", "artist": "Ricard Canals y Llambí", "artist_full": "Ricard Canals y Llambí (Spanish, 1876–1931)", "artist_id": 3970, "date_display": "1899", "date_start": 1899, "date_end": 1899, "medium": "Oil on canvas", "dimensions": "61.2 × 50.5 cm (24 × 20 in.)", "department": "Painting and Sculpture of Europe", "artwork_type": "Painting", "classification": "painting", "style": "19th century", "place_of_origin": "Seville", "credit_line": "Mr. and Mrs. Martin A. Ryerson Collection", "reference_number": "1933.1113", "gallery": null, "is_public_domain": true, "is_on_view": false, "image_id": "5965fe15-d8fa-3f39-031d-bb4a231560e0", "facets": "19th century painting Seville Oil on canvas", "images": { "thumbnail": "https://www.artic.edu/iiif/2/5965fe15-d8fa-3f39-031d-bb4a231560e0/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/5965fe15-d8fa-3f39-031d-bb4a231560e0/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/5965fe15-d8fa-3f39-031d-bb4a231560e0/full/1686,/0/default.jpg" }, "artic_url": "https://www.artic.edu/artworks/16473" } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/artworks": { "get": { "operationId": "searchArtworks", "summary": "Search Artworks", "description": "Search Artworks endpoint of the Artworks API. Costs 1 token per call.", "externalDocs": { "url": "https://dataandapis.com/apis/artworks/search-artworks" }, "parameters": [ { "name": "artist", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "department", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "25" }, { "name": "on_view", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "string" }, "example": "1" }, { "name": "public_domain", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "water lilies monet" }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "year_from", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "year_to", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "page": 1, "limit": 3, "total": 1, "total_pages": 1, "artworks": [ { "id": 16568, "title": "Water Lilies", "artist": "Claude Monet", "artist_full": "Claude Monet (French, 1840–1926)", "artist_id": 35809, "date_display": "1906", "date_start": 1906, "date_end": 1906, "medium": "Oil on canvas", "dimensions": "89.9 × 94.1 cm (35 3/8 × 37 1/16 in.); Framed: 103.2 × 107 × 5.8 cm (40 5/8 × 42 1/8 × 2 1/4 in.)", "department": "Painting and Sculpture of Europe", "artwork_type": "Painting", "classification": "oil on canvas", "style": "Impressionism", "place_of_origin": "France", "credit_line": "Mr. and Mrs. Martin A. Ryerson Collection", "reference_number": "1933.1157", "gallery": "Gallery 243", "is_public_domain": true, "is_on_view": true, "image_id": "3c27b499-af56-f0d5-93b5-a7f2f1ad5813", "facets": "Impressionism oil on canvas France Oil on canvas", "images": { "thumbnail": "https://www.artic.edu/iiif/2/3c27b499-af56-f0d5-93b5-a7f2f1ad5813/full/200,/0/default.jpg", "medium": "https://www.artic.edu/iiif/2/3c27b499-af56-f0d5-93b5-a7f2f1ad5813/full/843,/0/default.jpg", "large": "https://www.artic.edu/iiif/2/3c27b499-af56-f0d5-93b5-a7f2f1ad5813/full/1686,/0/default.jpg" }, "artic_url": "https://www.artic.edu/artworks/16568" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 1 token per call." } } }, "security": [ { "ApiKey": [] } ] }