shipapis
StarSubmit an APISubmit API

Wallhaven

Wallhaven — free tier with API key

🎬 MediaUNMONITORED
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.

—HOW IT'S SCORED ⓘ
Docs ↗
Status badge · for your READMEshipapis health badge: — · unmonitored
ON PROBE SCHEDULE

We probe a documented GET and expect 2xx JSON — full uptime and health score. Open provider docs ↗

Uptime historystarts after first probe

On our probe schedule. Uptime charts appear after the first check lands.

Example responsefrom provider docs — not verified by us
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 · 6On scheduleFULL DOCS ↗
On schedule — GET /api/v1/search awaits first probe
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

Not tracked yet. Shape-change history starts once this API joins our probe schedule.

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: Unpublished.

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?

Wallhaven is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.