shipapis
StarSubmit an APISubmit API

Wallhaven

Wallhaven — free tier with API key

🎬 MediaHEALTHYchecked 11h 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.

83HOW IT'S SCORED ⓘ
Docs ↗
Status badge · for your READMEshipapis health badge: 83 · healthy
Uptime history
79.2%90 days
79.3%30 days
349P50 · ms
3981P95 · ms
operationalpartialdownno data
Response time · last 48 checks
Fastest 149 ms, slowest 974 ms, most recent 283 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 · 6HealthyFULL DOCS ↗
Monitored path responding — GET /api/v1/search349 mschecked 11h 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 healthy with 79.2% uptime over 90 days and a 349 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.