Zum Inhalt springen
GET /v1/random

A random artwork (with image)

Live testen

10 freie Calls pro Tag — keine Anmeldung, kein API-Key. Geht durchs oanor-Gateway.

Eigene Header (optional)
api.oanor.com/clevelandart-api

Funktioniert. Hol dir einen API-Key und nutze sie in deinem Projekt.

API-Key holen

Code-Snippets

curl "https://api.oanor.com/clevelandart-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/clevelandart-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/clevelandart-api/v1/random");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/clevelandart-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

Echte Antwort dieses Endpoints, erfasst beim letzten Health-Check.

{
    "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",
            "accession_number": "1992.242",
            "share_license_status": "CC0"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:44.599Z",
        "request_id": "4bfbc3a9-0b31-4c28-8c0a-74cf36d8a9cf"
    },
    "status": "ok",
    "message": "Random artwork retrieved successfully",
    "success": true
}