{"openapi":"3.1.0","info":{"title":"Met Museum API","version":"1.0.0","description":"Search The Metropolitan Museum of Art open-access collection of 470,000+ objects, fetch full artwork details — artist, date, medium, culture, department, public-domain status and high-resolution images — and list the museum departments. Perfect for art, education, culture and gallery apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/museum-api","description":"oanor gateway"}],"tags":[{"name":"Collection"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/departments":{"get":{"operationId":"get_v1_departments","tags":["Collection"],"summary":"Collection departments","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":19,"departments":[{"id":1,"name":"American Decorative Arts"},{"id":3,"name":"Ancient West Asian Art"},{"id":4,"name":"Arms and Armor"},{"id":5,"name":"Arts of Africa, Oceania, and the Americas"},{"id":6,"name":"Asian Art"},{"id":7,"name":"The Cloisters"},{"id":8,"name":"The Costume Institute"},{"id":9,"name":"Drawings and Prints"},{"id":10,"name":"Egyptian Art"},{"id":11,"name":"European Paintings"},{"id":12,"name":"European Sculpture and Decorative Arts"},{"id":13,"name":"Greek and Roman Art"},{"id":14,"name":"Islamic Art"},{"id":15,"name":"The Robert Lehman Collection"},{"id":16,"name":"The Libraries"},{"id":17,"name":"Medieval Art"},{"id":18,"name":"Musical Instruments"},{"id":19,"name":"Photographs"},{"id":21,"name":"Modern Art"}]},"meta":{"timestamp":"2026-05-30T04:45:10.734Z","request_id":"2f41dc94-e1cb-4a5d-900b-13be26e30ddf"},"status":"ok","message":"Departments retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/object":{"get":{"operationId":"get_v1_object","tags":["Collection"],"summary":"Artwork details by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric object id","schema":{"type":"string"},"example":"436524"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":436524,"date":"1887","tags":["Sunflowers","Still Life"],"image":"https://images.metmuseum.org/CRDImages/ep/original/DP-41223-001.jpg","title":"Sunflowers","artist":"Vincent van Gogh","medium":"Oil on canvas","artist_bio":"Dutch, Zundert 1853–1890 Auvers-sur-Oise","department":"European Paintings","dimensions":"17 x 24 in. (43.2 x 61 cm)","object_url":"https://www.metmuseum.org/art/collection/search/436524","credit_line":"Rogers Fund, 1949","image_small":"https://images.metmuseum.org/CRDImages/ep/web-large/DP-41223-001.jpg","object_name":"Painting","is_highlight":false,"accession_year":"1949","classification":"Paintings","is_public_domain":true,"additional_images":[]},"meta":{"timestamp":"2026-05-30T04:45:11.544Z","request_id":"f2ca2186-d3e9-4bb8-b4c4-7a08b5258b95"},"status":"ok","message":"Object retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Collection"],"summary":"Search the collection","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"sunflowers"},{"name":"limit","in":"query","required":false,"description":"Max 1-20","schema":{"type":"string"},"example":"3"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"query":"sunflowers","total":134,"results":[{"id":437112,"date":"1881","tags":["Sunflowers","Still Life"],"title":"Bouquet of Sunflowers","artist":"Claude Monet","medium":"Oil on canvas","artist_bio":"French, Paris 1840–1926 Giverny","department":"European Paintings","dimensions":"39 3/4 x 32 in. (101 x 81.3 cm)","object_url":"https://www.metmuseum.org/art/collection/search/437112","credit_line":"H. O. Havemeyer Collection, Bequest of Mrs. H. O. Havemeyer, 1929","object_name":"Painting","is_highlight":false,"accession_year":"1929","classification":"Paintings","is_public_domain":false,"additional_images":[]},{"id":551786,"date":"ca. 332–200 B.C.","tags":["Birds","Lions","Boats","Hieratic"],"image":"https://images.metmuseum.org/CRDImages/eg/original/2-35.9.20a–w_EGDP014589-4594.jpg","title":"Book of the Dead of the Priest of Horus, Imhotep (Imuthes)","medium":"Papyrus, ink","period":"Early Ptolemaic Period","department":"Egyptian Art","dimensions":"Approximate measurements (framed): L. 21.9 m (71 ft. 10 3/16 in); H. 35 cm (1 ft. 1 3/4 in.). Length previously estimated at 63 ft. (19.2 m).","object_url":"https://www.metmuseum.org/art/collection/search/551786","credit_line":"Gift of  Edward S. Harkness, 1935","image_small":"https://images.metmuseum.org/CRDImages/eg/web-large/2-35.9.20a–w_EGDP014589-4594.jpg","object_name":"Papyrus, funerary, Book of the Dead, Imouthes, Imhotep, Imuthes","is_highlight":false,"accession_year":"1935","is_public_domain":true,"additional_images":["https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section1.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section2.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section3.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section4.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section5.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section6.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section7.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section8.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section9.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section10.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section11.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section12.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section13.jpg","https://images.metmuseum.org/CRDImages/eg/original/35.9.20a_w_Section14.jpg","https://images.metmuseum.org/CRDImages/eg/original/LC-35_9_20_Crocodiles.jpg","https://images.metmuseum.org/CRDImages/eg/original/LC-35_9_20_Solar_Cycle.jpg"]},{"id":729644,"date":"ca. 1890–96","tags":["Skeletons","Women"],"image":"https://images.metmuseum.org/CRDImages/dp/original/DP865112.jpg","title":"In proof of true love, a watercarrier skeleton arguing with a woman (Posada); two skeleton angels in upper corners (Manilla)","artist":"José Guadalupe Posada","medium":"Type-metal engraving and letterpress","artist_bio":"Mexican, Aguascalientes 1852–1913 Mexico City","department":"Drawings and Prints","dimensions":"Sheet: 15 3/4 × 11 13/16 in. (40 × 30 cm)","object_url":"https://www.metmuseum.org/art/collection/search/729644","credit_line":"The Elisha Whittelsey Collection, The Elisha Whittelsey Fund, 1946","image_small":"https://images.metmuseum.org/CRDImages/dp/web-large/DP865112.jpg","object_name":"Print","is_highlight":true,"accession_year":"1946","classification":"Prints","is_public_domain":true,"additional_images":[]}]},"meta":{"timestamp":"2026-05-30T04:45:12.925Z","request_id":"6194e388-943a-4fb5-94ff-3c37ef97931f"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":80000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":500000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6900,"monthly_call_quota":2000000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/museum-api"}