Skip to content
GET /v1/wallpaper

A wallpaper's detail, engagement and tags

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/wallhaven-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

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

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "id": "9mjoy1",
        "url": "https://wallhaven.cc/w/9mjoy1",
        "tags": [
            {
                "id": 2692,
                "name": "samurai",
                "purity": "sfw",
                "category": "Miscellaneous"
            },
            {
                "id": 479,
                "name": "digital art",
                "purity": "sfw",
                "category": "Digital"
            },
            {
                "id": 10743,
                "name": "Mount Fuji",
                "purity": "sfw",
                "category": "Landscapes"
            },
            {
                "id": 7,
                "name": "Japan",
                "purity": "sfw",
                "category": "Countries"
            },
            {
                "id": 2612,
                "name": "cherry blossom",
                "purity": "sfw",
                "category": "Plants"
            },
            {
                "id": 115,
                "name": "trees",
                "purity": "sfw",
                "category": "Landscapes"
            },
            {
                "id": 1265,
                "name": "forest",
                "purity": "sfw",
                "category": "Nature"
            },
            {
                "id": 190,
                "name": "clouds",
                "purity": "sfw",
                "category": "Miscellaneous"
            },
            {
                "id": 17182,
                "name": "panda",
                "purity": "sfw",
                "category": "Animals"
            },
            {
                "id": 12583,
                "name": "cherry trees",
                "purity": "sfw",
                "category": "Plants"
            },
            {
                "id": 4580,
                "name": "petals",
                "purity": "sfw",
                "category": "Plants"
            },
            {
                "id": 21849,
                "name": "gates",
                "purity": "sfw",
                "category": "Miscellaneous"
            },
            {
                "id": 1722,
                "name": "plants",
                "purity": "sfw",
                "category": "Plants"
            },
            {
                "id": 328,
                "name": "mountains",
                "purity": "sfw",
                "category": "Nature"
            },
            {
                "id": 20,
                "name": "river",
                "purity": "sfw",
                "category": "Landscapes"
            }
        ],
        "image": "https://w.wallhaven.cc/full/9m/wallhaven-9mjoy1.png",
        "ratio": "1.78",
        "thumb": "https://th.wallhaven.cc/small/9m/9mjoy1.jpg",
        "views": 842428,
        "colors": [
            "#424153",
            "#999999",
            "#cccccc",
            "#ffffff",
            "#fdadc7"
        ],
        "purity": "sfw",
        "source": "https://www.artstation.com/artwork/EaDP
…