API · /wallhaven-api

Wallhaven API

healthy 4,527 Subscribers

Live wallpaper-community data from Wallhaven as an API — search the large community wallpaper collection by keyword and category (general, anime, people), sorted by favourites, views or freshness, and read any wallpaper's community engagement (favourites and views) along with its resolution, aspect ratio, file type, dominant colours and tags. The visual-community engagement layer for wallpaper, design and dashboard apps. SFW-only by design — every request is forced to safe content. Live, no key, no cache. Distinct from generic image and stock-photo APIs — this is Wallhaven's own community wallpapers, their favourites/views engagement and tags.

#wallhaven #wallpapers #community #images #engagement #design #social

api.oanor.com/wallhaven-api

Get an API key Try in playground → Contact provider

Machine-readable spec so AI agents can integrate this API.

/api/wallhaven-api/openapi.json

/api/wallhaven-api/llms.txt

Discovery: GET /api/index.json lists every API.

Wallhaven API — live data on the oanor API marketplace

API health

healthy

Uptime: 100.00%; Server probes · 24h
Avg latency: 436 ms; Server probes · 24h
Subscribers: 4,527; active
Total calls: 114; last 7 days

Full status page → · 18 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

10,000 calls / month
5 requests / second
Hard cap (429 above quota, no overage)
10k calls/month
5 req/sec
All endpoints
No credit card

Starter

€8.00 /month

120,000 calls / month
15 requests / second
Hard cap (429 above quota, no overage)
120k calls/month
15 req/sec
Email support

Pro

€22.00 /month

630,000 calls / month
40 requests / second
Hard cap (429 above quota, no overage)
630k calls/month
40 req/sec
Priority support

Scale

€49.00 /month

3,200,000 calls / month
100 requests / second
Hard cap (429 above quota, no overage)
3.2M calls/month
100 req/sec
Dedicated SLA

Built by

PremiumApi

Related APIs

Other APIs with overlapping tags.

Chihuahua Chain API

Real-time on-chain data for Chihuahua (chain-id chihuahua-1), a community-driven Cosmos-SDK Layer-1 secured by delegated proof-of-stake with HUAHUA as its native coin. The status endpoint returns the chain id, latest block height and time, proposer and node application version so you can confirm the chain is live and producing blocks. The validators endpoint returns the full bonded validator set — each moniker, operator address, stake in HUAHUA, commission rate and jailed flag — sorted by stake, plus the total bonded and not-bonded HUAHUA. The supply endpoint returns the total HUAHUA supply (in HUAHUA and base uhuahua), the bonded amount and the bonded ratio. The governance endpoint returns the most recent on-chain governance proposals with title, status and voting window. The meta endpoint documents the chain, denom and decimals. Reads a live Chihuahua Cosmos-SDK LCD node directly (with mirror fallback), so values are current to the latest block. Live, nothing stored. 5 endpoints. This serves chain-level staking, supply and governance data; for token prices or NFTs use a dedicated market/indexer API.

api.oanor.com/chihuahua-api

OpenProcessing Creative Coding API

Live creator and sketch data from OpenProcessing, the community for Processing and p5.js creative-coding sketches, served from its public API. The user endpoint returns a creator's profile — username, name, bio, location, website, join date and total sketch count. The sketches endpoint lists a creator's published sketches with title, license, engine mode and dates. The sketch endpoint returns a single sketch's detail — title, description, tags, license, libraries used, the fork parent it was remixed from, and the author. The social endpoint returns a creator's followers or the accounts they follow. This is a creative-coding community stats API — creator profiles, sketch catalogues and the follow graph — distinct from the code-hosting, package-registry and other social-platform APIs in the catalogue. A user is a numeric OpenProcessing userID and a sketch is a numeric visualID, both visible in OpenProcessing URLs. Live, no key on the upstream, nothing stored.

api.oanor.com/openprocessing-api

Quaver Rhythm Game API

Live player and ranking data from Quaver, the competitive vertical-scrolling rhythm game (VSRG, 4-key and 7-key), served from its public v2 API. The player endpoint resolves a user by id or username and returns the profile — country, clan, avatar, linked Twitch/Twitter and join date — together with the full per-mode competitive stats for both 4K and 7K: global and country rank, performance rating, overall accuracy, ranked and total score, play count and the grade distribution (SS/S/A/B/C/D). The search endpoint finds players by name. The leaderboard endpoint returns the global ranked ladder for a mode, with each player's rank, performance rating, accuracy and play count. This is a single-game competitive-community stats API — player profiles, ratings and ladders — distinct from the other rhythm-game and gaming-leaderboard APIs in the catalogue. Live, no key on the upstream, nothing stored.

api.oanor.com/quaver-api

Modrinth Minecraft Mods API

Live mod-platform stats from Modrinth, the open Minecraft content platform — no key, nothing stored. The adoption-and-community view of the Minecraft modding ecosystem: how much each mod, modpack, shader or resource pack is downloaded and followed, and which projects are most popular, distinct from the other developer-ecosystem and gaming APIs in the catalogue. The project endpoint returns a single project in full — total downloads, followers, type, categories, supported game versions and loaders, client/server sides and license. The search endpoint searches projects, filterable by type (mod, modpack, shader, resource pack, data pack) and sortable by downloads or follows, each with its download and follower count. The versions endpoint returns a project's recent releases with per-version downloads, supported game versions and loaders. Build mod dashboards, popularity trackers, "is this mod maintained" widgets and modpack browsers on top of real Modrinth data. Look up a project by its slug (sodium, iris, fabric-api); downloads are the headline popularity metric.

api.oanor.com/modrinth-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for Wallhaven API?

Sign up for free at oanor.com, generate an API key from the developer dashboard, and call Wallhaven API with the x-oanor-key header. No credit card needed for the free tier.

What's the rate limit for Wallhaven API?

Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.

How much does Wallhaven API cost?

Wallhaven API has a free tier with 100 calls / month. Paid plans start at €8.00 / month with higher quotas and faster rate limits.

Can I cancel my subscription anytime?

Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.

Is Wallhaven API GDPR-compliant?

All requests to Wallhaven API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.

Search 1

Wallpaper 1

Meta 1

Wallpapers 2

Tags 1

Pick an endpoint from the list on the left to see its details and try it.

GET /v1/search

Search wallpapers by keyword and category

Playground

Parameters

Custom headers

Language: Client:

GET /v1/wallpaper

A wallpaper's detail, engagement and tags

Playground

Parameters

Custom headers

Language: Client:

GET /v1/meta

Service metadata

Playground

Custom headers

Language: Client:

GET /v1/random

A random page of wallpapers for discovery

Playground

Parameters

Custom headers

Language: Client:

GET /v1/toplist

Top wallpapers over a time range

Playground

Parameters

Custom headers

Language: Client:

GET /v1/tag

A tag's metadata (name, alias, category)

Playground

Parameters

Custom headers

Language: Client:

Code snippets

curl https://api.oanor.com/wallhaven-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."

const res = await fetch("https://api.oanor.com/wallhaven-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();

$ch = curl_init("https://api.oanor.com/wallhaven-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);

import requests
r = requests.get(
    "https://api.oanor.com/wallhaven-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

No reviews yet.

Discussion

Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.

New thread

📌 Pinned 🔒 Locked

· ·

🔒 This thread is locked — no new replies.

No threads yet — start the discussion.

Support

Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.

Open new ticket

Describe what you need help with. The provider team gets an email and replies on the ticket page.

No tickets yet for this API.

Subscription active — calls can start immediately.

Send your first request —

Subscription active — copy a snippet and fire off your first call.

Pick a key

Plaintext is shown once at creation — use the prefix as a reminder.

Wallhaven API

API health

Pricing

Built by

Related APIs

Chihuahua Chain API

OpenProcessing Creative Coding API

Quaver Rhythm Game API

Modrinth Minecraft Mods API

Frequently asked questions

Parameters

Parameters

Parameters

Parameters

Parameters

Code snippets

Ratings

Discussion

New thread

📌 🔒

Support

Open new ticket

Your cookie choices