Photography — entry 024 of 25
Wallhaven
Wallhaven's v1 API exposes its wallpaper-sharing community catalog for search, browsing, and per-wallpaper metadata over plain GET requests, mirroring the site's own filters for tags, resolution, aspect ratio, purity, and sorting. Anonymous requests only return SFW results; registering a free account and passing its API key as a query parameter unlocks sketchy/NSFW purities plus access to a user's own settings, uploads, and favorites. There is no paid tier — the whole API is free, rate-limited to 45 requests per minute per the response headers.
AuthenticationAPI KeySign up with the provider to obtain credentials.
HTTPSSupportedTraffic is encrypted in transit.
CORSDisabledBrowser calls need a server-side proxy.
PricingFreeNo paid tier — free for the documented use case.
FormatsJSONResponses can be requested as JSON.
GreatAPIs Score
Score64
Authentication15/25API key required
Pricing20/20Free to use
Docs0/20No docs or spec available
Formats9/15Single response format
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/wallhaven/"><img src="https://greatapis.com/badge/wallhaven.svg" alt="Scored 64 on greatapis.com"></a>Auth quickstart
- Sign up with the provider to get an API key.
- Send it on every request as a header
Authorization: <key> - The exact header isn't documented — Authorization is a common default; confirm in the provider's docs.
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.