/v1/random
A random artwork (with image)
Pruébalo en vivo
10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.
Funciona. Consigue una clave API y úsala en tu proyecto.
Obtener una clave APIFragmentos de código
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_..."}
)
Respuesta de ejemplo
Una respuesta real de este endpoint, capturada en la última comprobación de estado.
{
"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
}