# Met Museum API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/museum-api/..."
```

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 2 req/s
- **Basic** ($8/Mo) — 80,000 calls/Mo, 8 req/s
- **Pro** ($24/Mo) — 500,000 calls/Mo, 25 req/s
- **Mega** ($69/Mo) — 2,000,000 calls/Mo, 80 req/s

## Endpoints

### Collection

#### `GET /v1/departments` — Collection departments

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/museum-api/v1/departments"
```

**Response:**
```json
{
    "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"
            },
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/object` — Artwork details by id

**Parameters:**
- `id` (query, required, string) — Numeric object id Example: `436524`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/museum-api/v1/object?id=436524"
```

**Response:**
```json
{
    "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",
        "period": null,
        "culture": null,
        "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
}
```

#### `GET /v1/search` — Search the collection

**Parameters:**
- `q` (query, required, string) — Search term Example: `sunflowers`
- `limit` (query, optional, string) — Max 1-20 Example: `3`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/museum-api/v1/search?q=sunflowers&limit=3"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "query": "sunflowers",
        "total": 134,
        "results": [
            {
                "id": 437112,
                "date": "1881",
                "tags": [
                    "Sunflowers",
                    "Still Life"
                ],
                "image": null,
                "title": "Bouquet of Sunflowers",
                "artist": "Claude Monet",
                "medium": "Oil on canvas",
                "period": null,
                "culture": null,
                "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",
                "image_small": null,
                "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
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/museum-api
OpenAPI spec: https://www.oanor.com/api/museum-api/openapi.json