### Example Object Data - JSON Response Source: https://metmuseum.github.io/ This is an example of a JSON response for a specific object in the museum's collection. It includes details such as object ID, accession number, images, artist information, and dimensions. ```json { "objectID": 45734, "isHighlight": false, "accessionNumber": "36.100.45", "accessionYear": "1936", "isPublicDomain": true, "primaryImage": "https://images.metmuseum.org/CRDImages/as/original/DP251139.jpg", "primaryImageSmall": "https://images.metmuseum.org/CRDImages/as/web-large/DP251139.jpg", "additionalImages": [ "https://images.metmuseum.org/CRDImages/as/original/DP251138.jpg", "https://images.metmuseum.org/CRDImages/as/original/DP251120.jpg" ], "constituents": [ { "constituentID": 11986, "role": "Artist", "name": "Kiyohara Yukinobu", "constituentULAN_URL": "http://vocab.getty.edu/page/ulan/500034433", "constituentWikidata_URL": "https://www.wikidata.org/wiki/Q11560527", "gender": "Female" } ], "department": "Asian Art", "objectName": "Hanging scroll", "title": "Quail and Millet", "culture": "Japan", "period": "Edo period (1615–1868)", "dynasty": "", "reign": "", "portfolio": "", "artistRole": "Artist", "artistPrefix": "", "artistDisplayName": "Kiyohara Yukinobu", "artistDisplayBio": "Japanese, 1643–1868", "artistSuffix": "", "artistAlphaSort": "Kiyohara Yukinobu", "artistNationality": "Japanese", "artistBeginDate": "1643", "artistEndDate": "1682", "artistGender": "Female", "artistWikidata_URL": "https://www.wikidata.org/wiki/Q11560527", "artistULAN_URL": "http://vocab.getty.edu/page/ulan/500034433", "objectDate": "late 17th century", "objectBeginDate": 1667, "objectEndDate": 1682, "medium": "Hanging scroll; ink and color on silk", "dimensions": "46 5/8 x 18 3/4 in. (118.4 x 47.6 cm)", "measurements": [ { "elementName": "Overall", "elementDescription": null, "elementMeasurements": { "Height": 118.4, "Width": 47.6 } } ], "creditLine": "The Howard Mansfield Collection, Purchase, Rogers Fund, 1936", "geographyType": "", "city": "", "state": "", "county": "", "country": "", "region": "", "subregion": "", "locale": "", "locus": "", "excavation": "", "river": "", "classification": "Paintings", "rightsAndReproduction": "", "linkResource": "", "metadataDate": "2020-09-14T12:26:37.48Z", "repository": "Metropolitan Museum of Art, New York, NY", "objectURL": "https://www.metmuseum.org/art/collection/search/45734", "tags": [ { "term": "Birds", "AAT_URL": "http://vocab.getty.edu/page/aat/300266506", "Wikidata_URL": "https://www.wikidata.org/wiki/Q5113" } ], "objectWikidata_URL": "https://www.wikidata.org/wiki/Q29910832", "isTimelineWork": false, "GalleryNumber": "" } ``` -------------------------------- ### Retrieve object IDs response Source: https://metmuseum.github.io/ Example response structure for the objects endpoint. ```json { "total": 471581, "objectIDs": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, // more results ... ] } ``` -------------------------------- ### Retrieve object IDs by department response Source: https://metmuseum.github.io/ Example response for a department-specific object ID request. ```json { "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 ... ] } ``` -------------------------------- ### GET /public/collection/v1/search Source: https://metmuseum.github.io/ Search for objects in the collection based on a query string and optional parameters. ```APIDOC ## GET /public/collection/v1/search ### Description Search the collection for objects matching a query string and specific criteria. ### Method GET ### Endpoint https://collectionapi.metmuseum.org/public/collection/v1/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query term. - **departmentId** (integer) - Optional - Filter by department ID. - **isOnView** (boolean) - Optional - Filter by whether the object is currently on view. - **artistOrCulture** (boolean) - Optional - Filter by artist or culture. - **medium** (string) - Optional - Filter by medium (e.g., Quilts|Silk|Bedcovers). - **hasImages** (boolean) - Optional - Filter by whether the object has images. - **geoLocation** (string) - Optional - Filter by geographic location. - **dateBegin** (integer) - Optional - Start of the date range. - **dateEnd** (integer) - Optional - End of the date range. ### Response #### Success Response (200) - **total** (integer) - Total number of objects found. - **objectIDs** (array) - List of object IDs matching the search criteria. #### Response Example { "total": 361, "objectIDs": [437329, 436121, 436535] } ``` -------------------------------- ### GET /public/collection/v1/departments Source: https://metmuseum.github.io/ Retrieve a list of all available department IDs and names. ```APIDOC ## GET /public/collection/v1/departments ### Description Returns a list of all departments available in the collection. ### Method GET ### Endpoint https://collectionapi.metmuseum.org/public/collection/v1/departments ``` -------------------------------- ### GET /public/collection/v1/search Source: https://metmuseum.github.io/ Searches for object IDs that match a specific query and optional filters. ```APIDOC ## GET /public/collection/v1/search ### Description Returns a listing of all Object IDs for objects that contain the search query within the object’s data. ### Method GET ### Endpoint /public/collection/v1/search ### Parameters #### Query Parameters - **q** (string) - Required - Search term - **isHighlight** (boolean) - Optional - Filter by highlights - **title** (boolean) - Optional - Search against title field - **tags** (boolean) - Optional - Search against subject keyword tags - **departmentId** (integer) - Optional - Filter by department ID - **isOnView** (boolean) - Optional - Filter by objects on view - **artistOrCulture** (boolean) - Optional - Search against artist or culture field - **medium** (string) - Optional - Filter by medium - **hasImages** (boolean) - Optional - Filter by objects with images - **geoLocation** (string) - Optional - Filter by geographic location - **dateBegin** (integer) - Optional - Start date range - **dateEnd** (integer) - Optional - End date range ### Response #### Success Response (200) - **total** (int) - Total number of objects - **objectIDs** (int array) - List of object IDs #### Response Example { "total": 27, "objectIDs": [1, 2, 3] } ``` -------------------------------- ### Get All Departments - API Request Source: https://metmuseum.github.io/ This endpoint returns a listing of all departments within the museum. The `departmentId` from the response can be used as a query parameter for other endpoints. ```json https://collectionapi.metmuseum.org/public/collection/v1/departments ``` -------------------------------- ### GET /public/collection/v1/objects/[objectID] Source: https://metmuseum.github.io/ Retrieves a detailed record for a specific object, including open access data and image information. ```APIDOC ## GET /public/collection/v1/objects/[objectID] ### Description Returns a record for a specific object, containing all open access data about that object, including its image if available. ### Method GET ### Endpoint /public/collection/v1/objects/[objectID] ### Parameters #### Path Parameters - **objectID** (integer) - Required - The unique Object ID for an object. ``` -------------------------------- ### GET /public/collection/v1/departments Source: https://metmuseum.github.io/ Retrieves a list of all departments within the museum, including their unique IDs and display names. ```APIDOC ## GET /public/collection/v1/departments ### Description Returns a list of all departments in the museum collection. ### Method GET ### Endpoint /public/collection/v1/departments ### Response #### Success Response (200) - **departments** (array) - List of department objects #### Response Example { "departments": [ { "departmentId": 1, "displayName": "American Decorative Arts" } ] } ``` -------------------------------- ### GET /public/collection/v1/objects Source: https://metmuseum.github.io/ Retrieves a list of object IDs based on specific metadata dates and optional department filters. ```APIDOC ## GET /public/collection/v1/objects ### Description Returns a list of object IDs that match the provided metadata date and optional department filters. ### Method GET ### Endpoint /public/collection/v1/objects ### Parameters #### Query Parameters - **metadataDate** (string) - Required - The date of the metadata update. - **departmentIds** (string) - Optional - A pipe-separated list of department IDs to filter results. ### Response #### Success Response (200) - **total** (integer) - The total number of object IDs returned. - **objectIDs** (array) - A list of unique object IDs. #### Response Example { "total": 1000, "objectIDs": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] } ``` -------------------------------- ### Artwork Metadata Fields Source: https://metmuseum.github.io/ This section details the various fields available for describing artworks in the Met Museum's collection. Each field includes its name, data type, a description, and example values. ```APIDOC ## Artwork Metadata Fields This section details the various fields available for describing artworks in the Met Museum's collection. Each field includes its name, data type, a description, and example values. ### Fields - **objectEndDate** (int) - Machine readable date indicating the year the artwork was completed (may be the same year or different year than the objectBeginDate). Example: `1888`, `1100`, `-850` - **medium** (string) - Refers to the materials that were used to create the artwork. Example: `"Oil on canvas"`, `"Watercolor"`, `"Gold"` - **dimensions** (string) - Size of the artwork or object. Example: `"16 x 20 in. (40.6 x 50.8 cm)"` - **dimensionsParsed** (float) - Size of the artwork or object in centimeters, parsed. Example: `[{"element":"Sheet","dimensionType":"Height","dimension":51},{"element":"Plate","dimensionType":"Height","dimension":47.5},{"element":"Sheet","dimensionType":"Width","dimension":72.8},{"element":"Plate","dimensionType":"Width","dimension":62.5}]` - **measurements** (array) - Array of elements, each with a name, description, and set of measurements. Spatial measurements are in centimeters; weights are in kg. Example: `[ { "elementName": "Overall", "elementDescription": "Temple proper", "elementMeasurements": { "Height": 640.0813, "Length": 1249.6825, "Width": 640.0813 } } ]` - **creditLine** (string) - Text acknowledging the source or origin of the artwork and the year the object was acquired by the museum. Example: `"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. Example: `"Made in"`, `"From"`, `"Attributed to"` - **city** (string) - City where the artwork was created. Example: `"New York"`, `"Paris"`, `"Tokyo"` - **state** (string) - State or province where the artwork was created, may sometimes overlap with County. Example: `"Alamance"`, `"Derbyshire"`, `"Brooklyn"` - **county** (string) - County where the artwork was created, may sometimes overlap with State. Example: `"Orange County"`, `"Staffordshire"`, `"Brooklyn"` - **country** (string) - Country where the artwork was created or found. Example: `"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). Example: `"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). Example: `"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). Example: `"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). Example: `"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. Example: `"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). Example: `"Mississippi River"`, `"Nile River"`, `"River Thames"` - **classification** (string) - General term describing the artwork type. Example: `"Basketry"`, `"Ceramics"`, `"Paintings"` - **rightsAndReproduction** (string) - Credit line for artworks still under copyright. Example: `"© 2018 Estate of Pablo Picasso / Artists Rights Society (ARS), New York"` - **linkResource** (string) - URL to object's page on metmuseum.org. Example: `"https://www.metmuseum.org/art/collection/search/547802"` - **metadataDate** (datetime) - Date metadata was last updated. Example: `2018-10-17T10:24:43.197Z` - **repository** (string) - Example: `"Metropolitan Museum of Art, New York, NY"` - **objectURL** (string) - URL to object's page on metmuseum.org. Example: `"https://www.metmuseum.org/art/collection/search/547802"` - **tags** (array) - An array of subject keyword tags associated with the object and their respective AAT URL. Example: `[{"term": "Abstraction","AAT_URL": "http://vocab.getty.edu/page/aat/300056508","Wikidata_URL": "https://www.wikidata.org/wiki/Q162150"}]` - **objectWikidata_URL** (string) - Wikidata URL for the object. Example: `"https://www.wikidata.org/wiki/Q432253"` - **isTimelineWork** (boolean) - Whether the object is on the Timeline of Art History website. Example: `true` - **GalleryNumber** (string) - Gallery number, where available. Example: `"131"` ``` -------------------------------- ### GET /public/collection/v1/objects Source: https://metmuseum.github.io/ Retrieves a listing of all valid Object IDs available in the collection. This endpoint supports filtering by metadata date and department IDs. ```APIDOC ## GET /public/collection/v1/objects ### Description Retrieves a listing of all valid Object IDs available for access. This endpoint supports filtering by metadata date and department IDs. ### Method GET ### Endpoint /public/collection/v1/objects ### Parameters #### Query Parameters - **metadataDate** (datetime) - Optional - Returns any objects with updated data after this date. - **departmentIds** (integers) - Optional - Returns any objects in a specific department. Multiple IDs can be provided, delimited with the '|' character (e.g., 1|3|9|12). ### Response #### Success Response (200) - **total** (int) - The total number of publicly-available objects. - **objectIDs** (int array) - An array containing the object ID of publicly-available objects. ##### Example ###### Request ``` https://collectionapi.metmuseum.org/public/collection/v1/objects ``` ###### Response ```json { "total": 471581, "objectIDs": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ] } ``` ###### Request with department filter ``` https://collectionapi.metmuseum.org/public/collection/v1/objects?departmentIds=1 ``` ###### Response with department filter ```json { "total": 1000, "objectIDs": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ] } ``` ###### Request with multiple department filters ``` https://collectionapi.metmuseum.org/public/collection/v1/objects?departmentIds=3|9|12 ``` ###### Response with multiple department filters ```json { "total": 1000, "objectIDs": [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ] } ``` ``` -------------------------------- ### GET /public/collection/v1/departments Source: https://metmuseum.github.io/ Retrieves a list of all departments within the Metropolitan Museum of Art collection. The returned department IDs are used for filtering objects in other endpoints. ```APIDOC ## GET /public/collection/v1/departments ### Description Returns a listing of all departments in the museum collection. ### Method GET ### Endpoint https://collectionapi.metmuseum.org/public/collection/v1/departments ### Response #### Success Response (200) - **departments** (array) - An array containing the JSON objects that contain each department's departmentId and display name. - **departmentId** (int) - Department ID as an integer. - **displayName** (string) - Display name for a department. ``` -------------------------------- ### Search by Date Range Source: https://metmuseum.github.io/ Use `dateBegin` and `dateEnd` parameters to specify a range for the creation date of the objects. Dates should be in a year format. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?dateBegin=1700&dateEnd=1800&q=African ``` ```JSON { "total": 56, "objectIDs": [ 320993, 188180, 394199, // more results ... ] } ``` -------------------------------- ### Search by Medium Source: https://metmuseum.github.io/ Use the `medium` parameter to search for objects made from specific materials. Multiple mediums can be specified using the pipe symbol `|` as a separator. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?medium=Quilts|Silk|Bedcovers&q=quilt ``` ```JSON { "total": 15, "objectIDs": [ 229155, 227076, 229930, // more results ... ] } ``` -------------------------------- ### Search for Items Currently On View Source: https://metmuseum.github.io/ Use the `isOnView` parameter set to `true` to retrieve only objects that are currently on display in the museum. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?isOnView=true&q=sunflower ``` ```JSON { "total": 19, "objectIDs": [ 436524, 11922, 2032, // more results ... ] } ``` -------------------------------- ### Retrieve Specific Object Details Source: https://metmuseum.github.io/ Fetches full open access data for a specific object using its unique ID. ```http https://collectionapi.metmuseum.org/public/collection/v1/objects/[objectID] ``` -------------------------------- ### Retrieve Object IDs by Metadata Date Source: https://metmuseum.github.io/ Fetches a list of object IDs updated on or after a specific date. ```http https://collectionapi.metmuseum.org/public/collection/v1/objects?metadataDate=2018-10-22 ``` -------------------------------- ### Search for Items with Images Source: https://metmuseum.github.io/ Use the `hasImages` parameter set to `true` to retrieve only objects that have associated images available. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?hasImages=true&q=Auguste Renoir ``` ```JSON { "total": 66, "objectIDs": [ 436965, 191807, 722444, // more results ... ] } ``` -------------------------------- ### Retrieve all object IDs Source: https://metmuseum.github.io/ Fetches a list of all valid Object IDs available in the collection. ```http https://collectionapi.metmuseum.org/public/collection/v1/objects ``` -------------------------------- ### Retrieve object IDs by multiple departments Source: https://metmuseum.github.io/ Fetches object IDs filtered by multiple department IDs using the pipe delimiter. ```http https://collectionapi.metmuseum.org/public/collection/v1/objects?departmentIds=3|9|12 ``` -------------------------------- ### Retrieve Object IDs by Date and Department Source: https://metmuseum.github.io/ Filters the object ID list by metadata date and specific department IDs. ```http https://collectionapi.metmuseum.org/public/collection/v1/objects?metadataDate=2018-10-22&departmentIds=3|9|12 ``` -------------------------------- ### Artwork Object Fields Source: https://metmuseum.github.io/ This section details the fields returned in the response for artwork objects. ```APIDOC ## Artwork Object Fields ### Description This section details the fields returned in the response for artwork objects. ### Response #### Success Response (200) - **objectID** (int) - Identifying number for each artwork (unique, can be used as key field) - **isHighlight** (boolean) - When "true" indicates a popular and important artwork in the collection - **accessionNumber** (string) - Identifying number for each artwork (not always unique) - **accessionYear** (string) - Year the artwork was acquired. - **isPublicDomain** (boolean) - When "true" indicates an artwork in the Public Domain - **primaryImage** (string) - URL to the primary image of an object in JPEG format - **primaryImageSmall** (string) - URL to the lower-res primary image of an object in JPEG format - **additionalImages** (array) - An array containing URLs to the additional images of an object in JPEG format - **constituents** (array) - An array containing the constituents associated with an object, with the constituent's role, name, ULAN URL, Wikidata URL, and gender, when available (currently contains female designations only). - **department** (string) - Indicates The Met's curatorial department responsible for the artwork - **objectName** (string) - Describes the physical type of the object - **title** (string) - Title, identifying phrase, or name given to a work of art - **culture** (string) - Information about the culture, or people from which an object was created - **period** (string) - Time or time period when an object was created - **dynasty** (string) - Dynasty (a succession of rulers of the same line or family) under which an object was created - **reign** (string) - Reign of a monarch or ruler under which an object was created - **portfolio** (string) - A set of works created as a group or published as a series. - **artistRole** (string) - Role of the artist related to the type of artwork or object that was created - **artistPrefix** (string) - Describes the extent of creation or describes an attribution qualifier to the information given in the artistRole field - **artistDisplayName** (string) - Artist name in the correct order for display - **artistDisplayBio** (string) - Nationality and life dates of an artist, also includes birth and death city when known. - **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) - **artistAlphaSort** (string) - Used to sort artist names alphabetically. Last Name, First Name, Middle Name, Suffix, and Honorific fields, in that order. - **artistNationality** (string) - National, geopolitical, cultural, or ethnic origins or affiliation of the creator or institution that made the artwork - **artistBeginDate** (string) - Year the artist was born - **artistEndDate** (string) - Year the artist died - **artistGender** (string) - Gender of the artist (currently contains female designations only) - **artistWikidata_URL** (string) - Wikidata URL for the artist - **artistULAN_URL** (string) - ULAN URL for the artist - **objectDate** (string) - Year, a span of years, or a phrase that describes the specific or approximate date when an artwork was designed or created - **objectBeginDate** (int) - Machine readable date indicating the year the artwork was started to be created ### Response Example ```json { "objectID": 437133, "isHighlight": false, "accessionNumber": "67.241", "accessionYear": "1921", "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": [ { "constituentID": 161708, "role": "Artist", "name": "Louise Bourgeois", "constituentULAN_URL": "http://vocab.getty.edu/page/ulan/500057350", "constituentWikidata_URL": "https://www.wikidata.org/wiki/Q159409", "gender": "Female" } ], "department": "Egyptian Art", "objectName": "Dress", "title": "Wheat Field with Cypresses", "culture": "Afghan", "period": "Ming dynasty (1368-1644)", "dynasty": "Kingdom of Benin", "reign": "Amenhotep III", "portfolio": "Birds of America", "artistRole": "Artist for Painting", "artistPrefix": "In the Style of", "artistDisplayName": "Vincent van Gogh", "artistDisplayBio": "Dutch, Zundert 1853–1890 Auvers-sur-Oise", "artistSuffix": "verso only", "artistAlphaSort": "Gogh, Vincent van", "artistNationality": "Spanish", "artistBeginDate": "1840", "artistEndDate": "1926", "artistGender": "female", "artistWikidata_URL": "https://www.wikidata.org/wiki/Q694774", "artistULAN_URL": "https://vocab.getty.edu/page/ulan/500003169", "objectDate": "1865–67", "objectBeginDate": 1867 } ``` ``` -------------------------------- ### Retrieve object IDs by department Source: https://metmuseum.github.io/ Fetches object IDs filtered by a single department ID. ```http https://collectionapi.metmuseum.org/public/collection/v1/objects?departmentIds=1 ``` -------------------------------- ### Search by Department ID Source: https://metmuseum.github.io/ Use the `departmentId` parameter to filter search results by a specific department. Refer to the `/departments` endpoint for a list of valid IDs. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?departmentId=6&q=cat ``` ```JSON { "total": 361, "objectIDs": [ 437329, 436121, 436535, // more results ... ] } ``` -------------------------------- ### Search by Artist or Culture Source: https://metmuseum.github.io/ Filter search results by specifying an artist or culture using the `artistOrCulture` parameter. Set to `true` to enable this search type. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?artistOrCulture=true&q=french ``` ```JSON { "total": 14643, "objectIDs": [ 459199, 189708, 189709, // more results ... ] } ``` -------------------------------- ### Search by Geolocation Source: https://metmuseum.github.io/ Filter search results by geographical location using the `geoLocation` parameter. This is useful for finding objects associated with a specific place. ```HTTP https://collectionapi.metmuseum.org/public/collection/v1/search?geoLocation=France&q=flowers ``` ```JSON { "total": 3846, "objectIDs": [ 206979, 436175, 436121, // more results ... ] } ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.