Metropolitan Museum of Art Collection API

https://metmuseum.github.io/
Admin
The Metropolitan Museum of Art Collection API provides RESTful access to over 470,000 artworks from...
Tokens:7,151
Snippets:34
Trust Score:9.7
Update:6 months ago
Show doc for...
Tokens:
Raw
### 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 ...
	]
}
```
Tokens:
Raw