Ir al contenido
GET /v1/search

Search & filter artworks

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/clevelandart-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/clevelandart-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/clevelandart-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/clevelandart-api/v1/search");
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/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "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 time. This painting was very special to Monet and he kept it with him for his entire life.",
                "creation_date": "c. 1868–73",
                "accession_number": "1958.39",
                "share_license_status": "CC0"
            },
            {
                "id": 136510,
                "url": "https://clevelandart.org/art/1960.81",
                "type": "Painting",
                "image": "https://openaccess-cdn.clevelandart.org/1960.81/1960.81_web.jpg",
                "title": "Water Lilies (Agapanthus)",
                "culture": [
                    "France, late 19th century-early 20th century"
                ],
                "creators": [
                    "Claude Monet (French, 1840–1926)"
                ],
                "copyright": null,
                "technique": "oil on canvas",
                "department": "Modern European Painting and Sculpture",
                "dimensions": "Framed: 204.9 x 430.3 x 6 cm (80 11/16 x 169 7/16 x 2 3/8 in.); Unframed: 201.3 x 425.6 cm (79 1/4 x 167 9/16 in.)",
                "image_full": "https://openaccess-cdn.clevelandart.org/1960.81/1960.81_full.tif",
                "description": "A skilled horticulturalist as well as an artist, Claude Monet spent the last 30 years of his life painting the private garden he designed and helped cultivate at his home in Giverny in northern France. The resultant canvases are notable for their varied motifs, formats, and sizes. Monumental in scale, this rendering of 
…