A random artwork (with image)

Frammenti di codice

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_..."}
)

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo 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
}