Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/toplist

Top wallpapers over a time range

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

Example response

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

{
    "data": {
        "page": 1,
        "count": 24,
        "range": "1M",
        "total": 2053,
        "category": "all",
        "wallpapers": [
            {
                "id": "k82d26",
                "url": "https://wallhaven.cc/w/k82d26",
                "image": "https://w.wallhaven.cc/full/k8/wallhaven-k82d26.jpg",
                "ratio": "1.5",
                "thumb": "https://th.wallhaven.cc/small/k8/k82d26.jpg",
                "views": 32018,
                "colors": [
                    "#424153",
                    "#999999",
                    "#000000",
                    "#cccccc",
                    "#abbcda"
                ],
                "purity": "sfw",
                "category": "people",
                "favorites": 379,
                "file_size": 2155314,
                "file_type": "image/jpeg",
                "resolution": "4096x2731"
            },
            {
                "id": "w5m6yr",
                "url": "https://wallhaven.cc/w/w5m6yr",
                "image": "https://w.wallhaven.cc/full/w5/wallhaven-w5m6yr.jpg",
                "ratio": "1.78",
                "thumb": "https://th.wallhaven.cc/small/w5/w5m6yr.jpg",
                "views": 21385,
                "colors": [
                    "#333399",
                    "#66cccc",
                    "#999999",
                    "#424153",
                    "#0066cc"
                ],
                "purity": "sfw",
                "category": "general",
                "favorites": 154,
                "file_size": 1597629,
                "file_type": "image/jpeg",
                "resolution": "3840x2160"
            },
            {
                "id": "yqv2wx",
                "url": "https://wallhaven.cc/w/yqv2wx",
                "image": "https://w.wallhaven.cc/full/yq/wallhaven-yqv2wx.jpg",
                "ratio": "1.45",
                "thumb": "https://th.wallhaven.cc/small/yq/yqv2wx.jpg",
                "views": 19463,
                "colors": [
                    "#424153",
                    "#000000",
                    "#999999",
                    "#663399",
                    "#abbcda"
                ],
                "purity": "sfw",
                "category": "general",
                "favorites": 208,
                "file_size": 876938,
                "file_type": "image/jpeg",
                "resolution": "4335x2990"
            },
            {
                "id": "6lw16w",
                "url": "https://wallhaven.cc/w/6lw16w",
                "image": "https://w.wallhaven.cc/full/6l/wallhaven-6lw16w.jpg",
                "ratio": "0.56",
                "thumb": "https://th.wallhaven.cc/small/6l/6lw16w.jpg",
                "views": 16319,
                "colors": [
                    "#424153",
                    "#996633",
                    "#999999",
                    "#000000",
                    "#663300"
                ],
                "purity": "sfw",
     
…