# Cleveland Museum of Art API
> The Cleveland Museum of Art Open Access collection as an API — more than 60,000 artworks, over 30,000 of them with high-resolution, CC0 (public-domain) images you can use freely. Search and filter the collection by keyword, department, artwork type or artist, optionally limited to pieces that carry an image. Fetch any artwork by id for its full record: title, creators, creation date, culture, medium and technique, dimensions, department, description and "did you know" notes, on-view status and image URLs. Browse all works by a given creator, or pull a random artwork. Real museum data, no key needed upstream. Ideal for art apps, galleries and slideshows, education, generative-art projects and cultural research.

## 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/clevelandart-api/..."
```

## Pricing
- **Free** (Free) — 12,500 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 155,000 calls/Mo, 8 req/s
- **Pro** ($15/Mo) — 760,000 calls/Mo, 25 req/s
- **Mega** ($54/Mo) — 3,550,000 calls/Mo, 50 req/s

## Endpoints

### Artworks

#### `GET /v1/artwork` — A single artwork by id

**Parameters:**
- `id` (query, required, string) — Artwork id, e.g. 92937 Example: `92937`

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

**Response:**
```json
{
    "data": {
        "artwork": {
            "id": 92937,
            "url": "https://clevelandart.org/art/1922.1133",
            "type": "Painting",
            "image": "https://openaccess-cdn.clevelandart.org/1922.1133/1922.1133_web.jpg",
            "title": "Stag at Sharkey's",
            "culture": [
                "America"
            ],
            "creators": [
                "George Bellows (American, 1882–1925)"
            ],
            "copyright": null,
            "technique": "oil on canvas",
            "department": "American Painting and Sculpture",
            "dimensions": "Framed: 110 x 140.5 x 8.5 cm (43 5/16 x 55 5/16 x 3 3/8 in.); Unframed: 92 x 122.6 cm (36 1/4 x 48 1/4 in.)",
            "image_full": "https://openaccess-cdn.clevelandart.org/1922.1133/1922.1133_full.tif",
            "description": "Bellows was no stranger to Sharkey’s Athletic Club, a raucous saloon with a backroom boxing ring, located near his studio. Founded by Tom “Sailor” Sharkey, an ex-fighter who had also served in the US Navy, the club attracted men seeking to watch or participate in matches. Because public boxing was illegal in New York at the time, a private event had to be arranged in order for a bout to take place. Participation was usually limited to members of a particular club, but whenever an outsider competed, he was given temporary membership and known as a “stag.” Although boxing had its share of detractors who considered it uncouth at best o
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/creator` — Artworks by a creator

**Parameters:**
- `name` (query, required, string) — Creator name, e.g. Claude Monet Example: `Claude Monet`
- `limit` (query, optional, string) — Page size Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/clevelandart-api/v1/creator?name=Claude+Monet&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 5,
        "total": 5,
        "creator": "Claude Monet",
        "artworks": [
            {
                "id": 135382,
                "url": "https://clevelandart.org/art/1958.39",
                "type": "Painting",
                "image": "https://openaccess-cdn.clevelandart.org/1958.39/1958.39_web.jpg",
                "title": "The Red Kerchief",
                "culture": [
                    "France, 19th century"
                ],
                "creators": [
                    "Claude Monet (French, 1840–1926)"
                ],
                "copyright": null,
                "technique": "oil on fabric",
                "department": "Modern European Painting and Sculpture",
                "dimensions": "Framed: 128.3 x 105.7 x 14.6 cm (50 1/2 x 41 5/8 x 5 3/4 in.); Unframed: 99 x 79.8 cm (39 x 31 7/16 in.)",
                "image_full": "https://openaccess-cdn.clevelandart.org/1958.39/1958.39_full.tif",
                "description": "This painting depicts Monet's first wife, Camille, outside on a snowy day passing by the French doors of their home at Argenteuil. Her face is rendered in a radically bold Impressionist technique of mere daubs of paint quickly applied, just as the snow and trees are defined by broad, broken strokes of pure white and green.",
                "did_you_know": "Madame Monet’s red cape draws the viewer’s attention beyond the glass of the French doors capturing her glance, a brief momen
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/random` — A random artwork (with image)

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

**Response:**
```json
{
    "data": {
        "artwork": {
            "id": 156532,
            "url": "https://clevelandart.org/art/1992.242",
            "type": "Photograph",
            "image": "https://openaccess-cdn.clevelandart.org/1992.242/1992.242_web.jpg",
            "title": "Hell's Half Acre, Prismatic Springs",
            "culture": [
                "America"
            ],
            "creators": [
                "Frank Jay Haynes (American, 1853–1921)"
            ],
            "copyright": null,
            "technique": "albumen print from glass negative",
            "department": "Photography",
            "dimensions": "Image: 44.7 x 54.5 cm (17 5/8 x 21 7/16 in.); Paper: 45 x 55.1 cm (17 11/16 x 21 11/16 in.); Matted: 61 x 76.2 cm (24 x 30 in.)",
            "image_full": "https://openaccess-cdn.clevelandart.org/1992.242/1992.242_full.tif",
            "description": "Frank Jay Haynes was a photographer of life in the American West and the early days of Yellowstone National Park. Arriving in Yellowstone in the 1880s, he accompanied expeditions into the park, serving as official photographer. From canyon bottoms to mountain peaks, Haynes took his cameras to locations where he could capture unique and artistic views. In this photograph, he documented the immense space of the landscape, made particularly apparent by the inclusion of a small figure standing on the cliff at the right.",
            "did_you_know": null,
            "creation_date": "c. late 1880s",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search & filter artworks

**Parameters:**
- `q` (query, optional, string) — Keyword, e.g. monet Example: `monet`
- `department` (query, optional, string) — Department, e.g. Japanese Art
- `type` (query, optional, string) — Artwork type, e.g. Painting
- `artist` (query, optional, string) — Creator name
- `has_image` (query, optional, string) — Set 1 for artworks with an image Example: `1`
- `limit` (query, optional, string) — Page size (default 20, max 100) Example: `20`
- `skip` (query, optional, string) — Pagination offset Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/clevelandart-api/v1/search?q=monet&has_image=1&limit=20&skip=0"
```

**Response:**
```json
{
    "data": {
        "skip": 0,
        "count": 18,
        "total": 18,
        "artworks": [
            {
                "id": 135382,
                "url": "https://clevelandart.org/art/1958.39",
                "type": "Painting",
                "image": "https://openaccess-cdn.clevelandart.org/1958.39/1958.39_web.jpg",
                "title": "The Red Kerchief",
                "culture": [
                    "France, 19th century"
                ],
                "creators": [
                    "Claude Monet (French, 1840–1926)"
                ],
                "copyright": null,
                "technique": "oil on fabric",
                "department": "Modern European Painting and Sculpture",
                "dimensions": "Framed: 128.3 x 105.7 x 14.6 cm (50 1/2 x 41 5/8 x 5 3/4 in.); Unframed: 99 x 79.8 cm (39 x 31 7/16 in.)",
                "image_full": "https://openaccess-cdn.clevelandart.org/1958.39/1958.39_full.tif",
                "description": "This painting depicts Monet's first wife, Camille, outside on a snowy day passing by the French doors of their home at Argenteuil. Her face is rendered in a radically bold Impressionist technique of mere daubs of paint quickly applied, just as the snow and trees are defined by broad, broken strokes of pure white and green.",
                "did_you_know": "Madame Monet’s red cape draws the viewer’s attention beyond the glass of the French doors capturing her glance, a brief moment frozen in ti
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service description & endpoints

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

**Response:**
```json
{
    "data": {
        "service": "clevelandart-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/random": "A random artwork (with image).",
            "GET /v1/search": "Search/filter artworks (q=, department=, type=, artist=, has_image=1, limit=, skip=).",
            "GET /v1/artwork": "A single artwork by id (id=, e.g. 92937).",
            "GET /v1/creator": "Artworks by a creator (name=, e.g. Claude Monet)."
        },
        "description": "The Cleveland Museum of Art Open Access collection: search and filter 60k+ artworks by keyword, department, type or artist (optionally only those with a CC0 image), fetch a single artwork with its full metadata and imagery, browse a creator's works and pull a random artwork. Real museum data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:45.487Z",
        "request_id": "9a4d2511-e8f0-497a-a21a-e2a0df463e11"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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