shipapis
StarSubmit an APISubmit API

Wallhaven

Wallhaven — free tier with API key

🎬 MediaDYINGchecked 1h ago
AUTH APIKEYCORS ✗AGENT ✓HTTPS ✓COMMERCIAL ?

Wallhaven exposes a free-tier JSON API. Register for an API key if required; we verified a public or demo endpoint.

82HOW IT'S SCORED ⓘ
Docs ↗
Status badge · for your READMEshipapis health badge: 82 · dying
Uptime history
82.4%90 days
71.7%30 days
625P50 · ms
3981P95 · ms
operationalpartialdownno data
Response time · last 48 checks
Fastest 281 ms, slowest 2538 ms, most recent 367 ms.
Live response samplecaptured by our last successful check
GET https://wallhaven.cc/api/v1/search

{
  "data": [
    {
      "id": "mlg2rm",
      "url": "https://wallhaven.cc/w/mlg2rm",
      "short_url": "https://whvn.cc/mlg2rm",
      "views": 16,
      "favorites": 2,
      "source": "",
      "purity": "sfw",
      "category": "anime"
    },
    {
      "id": "7jermo",
      "url": "https://wallhaven.cc/w/7jermo",
      "short_url": "https://whvn.cc/7jermo",
      "views": 136,
      "favorites": 10,
      "source": "",
      "purity": "sfw",
      "category": "anime"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 20675,
    "per_page": 24,
    "total": 496177,
    "query": null,
    "seed": null
  }
}
Call itcurl · fetch · python
curl "https://wallhaven.cc/api/v1/search"
const res = await fetch("https://wallhaven.cc/api/v1/search");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://wallhaven.cc/api/v1/search")
print(res.json())

BROWSER CALLS BLOCKED (NO CORS/HTTPS) — USE THE CURL SNIPPET

Endpoints · 6DyingFULL DOCS ↗
Dying — error rate climbing on GET /api/v1/search625 mschecked 1h ago
GET/api/v1/searchPROBED

Wallhaven — free tier with API key

GET/api

Api — documented GET route.

GET/api/1

Api details by ID (example: 1).

GET/api?limit=10

Api — documented GET route.

GET/api/search?q=test

Search by query parameters.

GET/api/v1/w/94x38z

94x38z — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

Wallhaven: common questions

Is Wallhaven free to use?

Yes — Wallhaven is a free media API. Free tier: Free tier — key may be required. Whether the free tier allows commercial use is unclear — check the provider docs.

Does Wallhaven need an API key?

Yes — Wallhaven needs a free API key, which you pass on each request. Rate limits: 45 req/window · 44 remaining.

Can I call Wallhaven from the browser?

Not directly — Wallhaven doesn't send browser-friendly CORS headers, so call it from a server or proxy instead. Copy the curl or Python snippet on this page to get started.

Is Wallhaven up right now?

As of our last scheduled check, Wallhaven is dying with 82.4% uptime over 90 days and a 625 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.