View on GitHub

The Metropolitan Museum of Art Collection API

For more information about the Metropolitan Museum of Art Collection API, please visit our Open Access Github page https://github.com/metmuseum/openaccess.

The use of the Metropolitan Museum of Art Collection API is subject to these terms and conditions.

Issues regarding this API can be emailed to openaccess@metmuseum.org.

The Metropolitan Museum of Art Collection API

The Metropolitan Museum of Art presents over 5,000 years of art from around the world for everyone to experience and enjoy. The Museum lives in three iconic sites in New York City—The Met Fifth Avenue, The Met Breuer, and The Met Cloisters. Millions of people also take part in The Met experience online.

Since it was founded in 1870, The Met has always aspired to be more than a treasury of rare and beautiful objects. Every day, art comes alive in the Museum’s galleries and through its exhibitions and events, revealing both new ideas and unexpected connections across time and across cultures.

The Metropolitan Museum of Art provides select datasets of information on more than 470,000 artworks in its Collection for unrestricted commercial and noncommercial use. To the extent possible under law, The Metropolitan Museum of Art has waived all copyright and related or neighboring rights to this dataset using the Creative Commons Zero license. This work is published from the United States of America. These select datasets are now available for use in any media without permission or fee; they also include identifying data for artworks under copyright. The datasets support the search, use, and interaction with the Museum’s collection.

The Met’s Open Access datasets are available through our API. The API (RESTful web service in JSON format) gives access to all of The Met’s Open Access data and to corresponding high resolution images (JPEG format) that are in the public domain.

Access to the API

At this time, we do not require API users to register or obtain an API key to use the service.

Endpoints

There are API endpoints available for the following elements:

Objects

GET /public/collection/v1/objects returns a listing of all valid Object IDs available to use

Parameter Format Notes
metadataDate datetime e.g. YYYY-MM-DD Returns any objects with updated data after this date

Request

https://collectionapi.metmuseum.org/public/collection/v1/objects

Response

Field Type Default Notes
total int The total number of publicly-available objects
objectIDs int array [] An array containing the object ID of publicly-available object
Example
Request
https://collectionapi.metmuseum.org/public/collection/v1/objects
{
	"total": 471581,
	"objectIDs": [
		1,
		2,
		3,
		4,
		5,
		6,
		7,
		8,
		9,
		10,
		// more results ...
	]
}
Request
https://collectionapi.metmuseum.org/public/collection/v1/objects?metadataDate=2018-10-22
{
	"total": 1000, // less than the full amount of publicly-available object IDs
	"objectIDs": [
		1,
		2,
		3,
		4,
		5,
		6,
		7,
		8,
		9,
		10,
		// more results ...
	]
}

Object

GET /public/collection/v1/objects/[objectID] returns a record for an object, containing all open access data about that object, including its image (if the image is available under Open Access)

Parameter Format Notes
objectID 0-9 The unique Object ID for an object

Request

https://collectionapi.metmuseum.org/public/collection/v1/objects/[objectID]

Response

Field Type Notes Example(s)
objectID int Identifying number for each artwork (unique, can be used as key field) 437133
isHighlight boolean When "true" indicates a popular and important artwork in the collection Vincent van Gogh's "Wheat Field with Cypresses"
accessionNumber string Identifying number for each artwork (not always unique) 67.241
isPublicDomain boolean When "true" indicates an artwork in the Public Domain Vincent van Gogh's "Wheat Field with Cypresses"
primaryImage string URL to the primary image of an object in JPEG format https://images.metmuseum.org/CRDImages/ep/original/DT1567.jpg
primaryImageSmall string URL to the lower-res primary image of an object in JPEG format https://images.metmuseum.org/CRDImages/ep/web-large/DT1567.jpg
additionalImages array An array containing URLs to the additional images of an object in JPEG format ["https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-004.jpg", "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-003.jpg", "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-002.jpg", "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-001.jpg"]
constituents array An array containing the constituents of an object, with both an artist name and their role [{"role":"Artist","name":"Vincent van Gogh"}]
department string Indicates The Met's curatorial department responsible for the artwork 437133
objectName string Describes the physical type of the object Dress, Painting, Photograph, Vase
title string Title, identifying phrase, or name given to a work of art Wheat Field with Cypresses
culture string Information about the culture, or people from which an object was created Afgan, British, North African
period string Time or time period when an object was created Ming dynasty (1368-1644), Middle Bronze Age
dynasty string Dynasty (a succession of rulers of the same line or family) under which an object was created Kingdom of Benin, Dynasty 12
reign string Reign of a monarch or ruler under which an object was created Amenhotep III, Darius I, Louis XVI,
portfolio string A set of works created as a group or published as a series. Birds of America, The Hudson River Portfolio, Speculum Romanae Magnificentiae
artistRole string Role of the artist related to the type of artwork or object that was created Artist for Painting, Designer for Dress
artistPrefix string Describes the extent of creation or describes an attribution qualifier to the information given in the artistRole field In the Style of, Possibly by, Written in French by
artistDisplayName string Artist name in the correct order for display Vincent van Gogh
artistDisplayBio string Nationality and life dates of an artist, also includes birth and death city when known. Dutch, Zundert 1853–1890 Auvers-sur-Oise
artistSuffix string Used to record complex information that qualifies the role of a constituent, e.g. extent of participation by the Constituent (verso only, and followers) or, workshop, for, verso only
artistAlphaSort string Used to sort artist names alphabetically. Last Name, First Name, Middle Name, Suffix, and Honorific fields, in that order. Gogh, Vincent van
artistNationality string National, geopolitical, cultural, or ethnic origins or affiliation of the creator or institution that made the artwork Spanish; Dutch; French, born Romania
artistBeginDate string Year the artist was born 1840
artistEndDate string Year the artist died 1926
objectDate string Year, a span of years, or a phrase that describes the specific or approximate date when an artwork was designed or created 1865–67, 19th century, ca. 1796
objectBeginDate string Machine readable date indicating the year the artwork was started to be created 1867, 1100, -900
objectEndDate string Machine readable date indicating the year the artwork was completed (may be the same year or different year than the objectBeginDate) 1888, 1100, -850
medium string Refers to the materials that were used to create the artwork Oil on canvas, Watercolor, Gold
dimensions string Size of the artwork or object 16 x 20 in. (40.6 x 50.8 cm)
creditLine string Text acknowledging the source or origin of the artwork and the year the object was acquired by the museum. Robert Lehman Collection, 1975
geographyType string Qualifying information that describes the relationship of the place catalogued in the geography fields to the object that is being catalogued Made in, From, Attributed to
city string City where the artwork was created New York, Paris, Tokyo
state string State or province where the artwork was created, may sometimes overlap with County Alamance, Derbyshire, Brooklyn
county string County where the artwork was created, may sometimes overlap with State Orange County, Staffordshire, Brooklyn
country string Country where the artwork was created or found China, France, India
region string Geographic location more specific than country, but more specific than subregion, where the artwork was created or found (frequently null) Bohemia, Midwest, Southern
subregion string Geographic location more specific than Region, but less specific than Locale, where the artwork was created or found (frequently null) Malqata, Deir el-Bahri, Valley of the Kings
locale string Geographic location more specific than subregion, but more specific than locus, where the artwork was found (frequently null) Tomb of Perneb, Temple of Hatshepsut, Palace of Ramesses II
locus string Geographic location that is less specific than locale, but more specific than excavation, where the artwork was found (frequently null) 1st chamber W. wall; Burial C 2, In coffin; Pit 477
excavation string The name of an excavation. The excavation field usually includes dates of excavation. MMA excavations, 1923–24; Khashaba excavations, 1910–11; Carnarvon excavations, 1912
river string River is a natural watercourse, usually freshwater, flowing toward an ocean, a lake, a sea or another river related to the origins of an artwork (frequently null) Mississippi River, Nile River, River Thames
classification string General term describing the artwork type. Basketry, Ceramics, Paintings
rightsAndReproduction string Credit line for artworks still under copyright. © 2018 Estate of Pablo Picasso / Artists Rights Society (ARS), New York
linkResource string URL to object's page on metmuseum.org https://www.metmuseum.org/art/collection/search/547802
metadataDate datetime Date metadata was last updated 2018-10-17T10:24:43.197Z
repository string Metropolitan Museum of Art, New York, NY
objectURL string URL to object's page on metmuseum.org https://www.metmuseum.org/art/collection/search/547802
Example
{
  "objectID": 436535,
  "isHighlight": true,
  "accessionNumber": "1993.132",
  "isPublicDomain": true,
  "primaryImage": "https://images.metmuseum.org/CRDImages/ep/original/DT1567.jpg",
  "primaryImageSmall": "https://images.metmuseum.org/CRDImages/ep/web-large/DT1567.jpg",
  "additionalImages": [
    "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-004.jpg",
    "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-003.jpg",
    "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-002.jpg",
    "https://images.metmuseum.org/CRDImages/ep/original/LC-EP_1993_132_suppl_CH-001.jpg"
  ],  
  "constituents": [
    {
      "role": "Artist",
      "name": "Vincent van Gogh"
    }
  ],
  "department": "European Paintings",
  "objectName": "Painting",
  "title": "Wheat Field with Cypresses",
  "culture": "",
  "period": "",
  "dynasty": "",
  "reign": "",
  "portfolio": "",
  "artistRole": "Artist",
  "artistPrefix": "",
  "artistDisplayName": "Vincent van Gogh",
  "artistDisplayBio": "Dutch, Zundert 1853–1890 Auvers-sur-Oise",
  "artistSuffix": "",
  "artistAlphaSort": "Gogh, Vincent van",
  "artistNationality": "Dutch",
  "artistBeginDate": "1853",
  "artistEndDate": "1890",
  "objectDate": "1889",
  "objectBeginDate": 1889,
  "objectEndDate": 1889,
  "medium": "Oil on canvas",
  "dimensions": "28 7/8 × 36 3/4 in. (73.2 × 93.4 cm)",
  "creditLine": "Purchase, The Annenberg Foundation Gift, 1993",
  "geographyType": "",
  "city": "",
  "state": "",
  "county": "",
  "country": "",
  "region": "",
  "subregion": "",
  "locale": "",
  "locus": "",
  "excavation": "",
  "river": "",
  "classification": "Paintings",
  "rightsAndReproduction": "",
  "linkResource": "",
  "metadataDate": "2018-10-19T14:00:42.01Z",
  "repository": "Metropolitan Museum of Art, New York, NY",
  "objectURL": "https://www.metmuseum.org/art/collection/search/436535"
}