{"openapi":"3.1.0","info":{"title":"Wallhaven API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wallhaven-api","description":"oanor gateway"}],"tags":[{"name":"Search"},{"name":"Wallpaper"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Search SFW wallpapers by keyword and category","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Keyword / tag","schema":{"type":"string"},"example":"mountains"},{"name":"category","in":"query","required":false,"description":"general|anime|people|all","schema":{"type":"string"},"example":"anime"},{"name":"sort","in":"query","required":false,"description":"favorites|views|date_added|relevance","schema":{"type":"string"},"example":"favorites"},{"name":"page","in":"query","required":false,"description":"Page (1-50)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"sort":"favorites","count":24,"query":"mountains","total":721,"category":"anime","wallpapers":[{"id":"9mjoy1","url":"https://wallhaven.cc/w/9mjoy1","image":"https://w.wallhaven.cc/full/9m/wallhaven-9mjoy1.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/9m/9mjoy1.jpg","views":842422,"colors":["#424153","#999999","#cccccc","#ffffff","#fdadc7"],"purity":"sfw","category":"anime","favorites":5671,"file_size":15842713,"file_type":"image/png","resolution":"3840x2160"},{"id":"72yzje","url":"https://wallhaven.cc/w/72yzje","image":"https://w.wallhaven.cc/full/72/wallhaven-72yzje.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/72/72yzje.jpg","views":169559,"colors":["#424153","#000000","#333399","#0066cc","#66cccc"],"purity":"sfw","category":"anime","favorites":983,"file_size":14696837,"file_type":"image/jpeg","resolution":"5120x2880"},{"id":"7p3we9","url":"https://wallhaven.cc/w/7p3we9","image":"https://w.wallhaven.cc/full/7p/wallhaven-7p3we9.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/7p/7p3we9.jpg","views":74811,"colors":["#424153","#999999","#abbcda","#663399","#ea4c88"],"purity":"sfw","category":"anime","favorites":941,"file_size":10753258,"file_type":"image/png","resolution":"7680x4320"},{"id":"y8o7yg","url":"https://wallhaven.cc/w/y8o7yg","image":"https://w.wallhaven.cc/full/y8/wallhaven-y8o7yg.jpg","ratio":"2.25","thumb":"https://th.wallhaven.cc/small/y8/y8o7yg.jpg","views":61626,"colors":["#999999","#424153","#663399","#333399","#cccccc"],"purity":"sfw","category":"anime","favorites":639,"file_size":869066,"file_type":"image/jpeg","resolution":"2879x1278"},{"id":"gp7mq3","url":"https://wallhaven.cc/w/gp7mq3","image":"https://w.wallhaven.cc/full/gp/wallhaven-gp7mq3.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/gp/gp7mq3.jpg","views":116020,"colors":["#abbcda","#66cccc","#0066cc","#424153","#e7d8b1"],"purity":"sfw","category":"anime","favorites":534,"file_size":583277,"file_type":"image/jpeg","resolution":"3840x2160"},{"id":"p9ozm9","url":"https://wallhaven.cc/w/p9ozm9","image":"https://w.wallhaven.cc/full/p9/wallhaven-p9ozm9.jpg","ratio":"2.06","thumb":"https://th.wallhaven.cc/small/p9/p9ozm9.jpg","views":48347,"colors":["#999999","#abbcda","#cccccc","#424153","#ffffff"],"purity":"sfw","category":"anime","favorites":480,"file_size":5491959,"file_type":"image/jpeg","resolution":"6528x3175"},{"id":"x67zko","url":"https://wallhaven.cc/w/x67zko","image":"https://w.wallhaven.cc/full/x6/wallhaven-x67zko.jpg","ratio":"2.33","thumb":"https://th.wallhaven.cc/small/x6/x67zko.jpg","views":46186,"colors":["#424153","#000000","#999999","#663399","#cccccc"],"purity":"sfw","category":"anime","favorites":461,"file_size":6937814,"file_type":"image/jpeg","resolution":"3360x1440"},{"id":"x8movl","url":"https://wallhaven.cc/w/x8movl","image":"https://w.wallhaven.cc/full/x8/wallhaven-x8movl.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/x8/x8movl.jpg","views":129712,"colors":["#fdadc7","#424153","#e7d8b1","#ea4c88","#993399"],"purity":"sfw","category":"anime","favorites":453,"file_size":3277269,"file_type":"image/png","resolution":"3840x2160"},{"id":"m9jjp9","url":"https://wallhaven.cc/w/m9jjp9","image":"https://w.wallhaven.cc/full/m9/wallhaven-m9jjp9.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/m9/m9jjp9.jpg","views":135719,"colors":["#66cccc","#424153","#abbcda","#cccccc","#0066cc"],"purity":"sfw","category":"anime","favorites":432,"file_size":459747,"file_type":"image/jpeg","resolution":"1920x1080"},{"id":"1k5kdg","url":"https://wallhaven.cc/w/1k5kdg","image":"https://w.wallhaven.cc/full/1k/wallhaven-1k5kdg.jpg","ratio":"1.62","thumb":"https://th.wallhaven.cc/small/1k/1k5kdg.jpg","views":150383,"colors":["#999999","#424153","#abbcda","#66cccc","#cccccc"],"purity":"sfw","category":"anime","favorites":426,"file_size":1283026,"file_type":"image/jpeg","resolution":"2204x1364"},{"id":"l83k62","url":"https://wallhaven.cc/w/l83k62","image":"https://w.wallhaven.cc/full/l8/wallhaven-l83k62.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/l8/l83k62.jpg","views":48930,"colors":["#424153","#000000","#996633","#ea4c88","#cc3333"],"purity":"sfw","category":"anime","favorites":406,"file_size":3166211,"file_type":"image/jpeg","resolution":"3840x2160"},{"id":"p98e7e","url":"https://wallhaven.cc/w/p98e7e","image":"https://w.wallhaven.cc/full/p9/wallhaven-p98e7e.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/p9/p98e7e.jpg","views":62562,"colors":["#424153","#0066cc","#abbcda","#66cccc","#999999"],"purity":"sfw","category":"anime","favorites":400,"file_size":2333739,"file_type":"image/jpeg","resolution":"2799x1575"},{"id":"6lkrow","url":"https://wallhaven.cc/w/6lkrow","image":"https://w.wallhaven.cc/full/6l/wallhaven-6lkrow.png","ratio":"1.44","thumb":"https://th.wallhaven.cc/small/6l/6lkrow.jpg","views":24774,"colors":["#424153","#333399","#000000","#999999","#663399"],"purity":"sfw","category":"anime","favorites":330,"file_size":11231602,"file_type":"image/png","resolution":"6148x4262"},{"id":"p9l8lm","url":"https://wallhaven.cc/w/p9l8lm","image":"https://w.wallhaven.cc/full/p9/wallhaven-p9l8lm.jpg","ratio":"0.71","thumb":"https://th.wallhaven.cc/small/p9/p9l8lm.jpg","views":45347,"colors":["#333399","#0066cc","#000000","#424153","#e7d8b1"],"purity":"sfw","category":"anime","favorites":301,"file_size":19799427,"file_type":"image/jpeg","resolution":"2827x4000"},{"id":"72myve","url":"https://wallhaven.cc/w/72myve","image":"https://w.wallhaven.cc/full/72/wallhaven-72myve.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/72/72myve.jpg","views":31965,"colors":["#424153","#77cc33","#999999","#66cccc","#cccccc"],"purity":"sfw","category":"anime","favorites":300,"file_size":12528456,"file_type":"image/png","resolution":"3840x2160"},{"id":"qrgqyq","url":"https://wallhaven.cc/w/qrgqyq","image":"https://w.wallhaven.cc/full/qr/wallhaven-qrgqyq.jpg","ratio":"2.37","thumb":"https://th.wallhaven.cc/small/qr/qrgqyq.jpg","views":17576,"colors":["#424153","#000000","#999999","#663399","#663300"],"purity":"sfw","category":"anime","favorites":294,"file_size":12757167,"file_type":"image/jpeg","resolution":"6982x2948"},{"id":"ex9g7k","url":"https://wallhaven.cc/w/ex9g7k","image":"https://w.wallhaven.cc/full/ex/wallhaven-ex9g7k.png","ratio":"0.63","thumb":"https://th.wallhaven.cc/small/ex/ex9g7k.jpg","views":54946,"colors":["#333399","#cccccc","#999999","#424153","#ffffff"],"purity":"sfw","category":"anime","favorites":282,"file_size":16374333,"file_type":"image/png","resolution":"2500x4000"},{"id":"6or7gx","url":"https://wallhaven.cc/w/6or7gx","image":"https://w.wallhaven.cc/full/6o/wallhaven-6or7gx.jpg","ratio":"1.88","thumb":"https://th.wallhaven.cc/small/6o/6or7gx.jpg","views":49684,"colors":["#999999","#424153","#996633","#663300","#cccccc"],"purity":"sfw","category":"anime","favorites":277,"file_size":711865,"file_type":"image/jpeg","resolution":"3200x1700"},{"id":"gpjo6e","url":"https://wallhaven.cc/w/gpjo6e","image":"https://w.wallhaven.cc/full/gp/wallhaven-gpjo6e.jpg","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/gp/gpjo6e.jpg","views":43117,"colors":["#999999","#424153","#0099cc","#333399","#0066cc"],"purity":"sfw","category":"anime","favorites":270,"file_size":1641076,"file_type":"image/jpeg","resolution":"2560x1600"},{"id":"vqdgpp","url":"https://wallhaven.cc/w/vqdgpp","image":"https://w.wallhaven.cc/full/vq/wallhaven-vqdgpp.jpg","ratio":"1.7","thumb":"https://th.wallhaven.cc/small/vq/vqdgpp.jpg","views":28451,"colors":["#000000","#424153","#cccccc","#abbcda","#ffffff"],"purity":"sfw","category":"anime","favorites":267,"file_size":8570541,"file_type":"image/jpeg","resolution":"9600x5653"},{"id":"x69l7v","url":"https://wallhaven.cc/w/x69l7v","image":"https://w.wallhaven.cc/full/x6/wallhaven-x69l7v.jpg","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/x6/x69l7v.jpg","views":41906,"colors":["#000000","#424153","#999999","#996633","#cccccc"],"purity":"sfw","category":"anime","favorites":260,"file_size":10297167,"file_type":"image/jpeg","resolution":"4500x2813"},{"id":"y8qe1l","url":"https://wallhaven.cc/w/y8qe1l","image":"https://w.wallhaven.cc/full/y8/wallhaven-y8qe1l.jpg","ratio":"1.5","thumb":"https://th.wallhaven.cc/small/y8/y8qe1l.jpg","views":38258,"colors":["#424153","#000000","#66cccc","#0066cc","#333399"],"purity":"sfw","category":"anime","favorites":240,"file_size":595813,"file_type":"image/jpeg","resolution":"1920x1277"},{"id":"6o2qkw","url":"https://wallhaven.cc/w/6o2qkw","image":"https://w.wallhaven.cc/full/6o/wallhaven-6o2qkw.jpg","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/6o/6o2qkw.jpg","views":24322,"colors":["#424153","#000000","#999999","#996633","#abbcda"],"purity":"sfw","category":"anime","favorites":239,"file_size":8295530,"file_type":"image/jpeg","resolution":"4030x2519"},{"id":"jxd9eq","url":"https://wallhaven.cc/w/jxd9eq","image":"https://w.wallhaven.cc/full/jx/wallhaven-jxd9eq.jpg","ratio":"1.74","thumb":"https://th.wallhaven.cc/small/jx/jxd9eq.jpg","views":56240,"colors":["#999999","#424153","#000000","#abbcda","#cccccc"],"purity":"sfw","category":"anime","favorites":236,"file_size":3937436,"file_type":"image/jpeg","resolution":"4000x2300"}]},"meta":{"timestamp":"2026-06-09T03:02:05.192Z","request_id":"556bb974-94bf-43e2-955f-7d311aedd772"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/wallpaper":{"get":{"operationId":"get_v1_wallpaper","tags":["Wallpaper"],"summary":"A wallpaper detail, engagement and tags","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Wallhaven wallpaper id","schema":{"type":"string"},"example":"9mjoy1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"9mjoy1","url":"https://wallhaven.cc/w/9mjoy1","tags":[{"id":2692,"name":"samurai","purity":"sfw","category":"Miscellaneous"},{"id":479,"name":"digital art","purity":"sfw","category":"Digital"},{"id":10743,"name":"Mount Fuji","purity":"sfw","category":"Landscapes"},{"id":7,"name":"Japan","purity":"sfw","category":"Countries"},{"id":2612,"name":"cherry blossom","purity":"sfw","category":"Plants"},{"id":115,"name":"trees","purity":"sfw","category":"Landscapes"},{"id":1265,"name":"forest","purity":"sfw","category":"Nature"},{"id":190,"name":"clouds","purity":"sfw","category":"Miscellaneous"},{"id":17182,"name":"panda","purity":"sfw","category":"Animals"},{"id":12583,"name":"cherry trees","purity":"sfw","category":"Plants"},{"id":4580,"name":"petals","purity":"sfw","category":"Plants"},{"id":21849,"name":"gates","purity":"sfw","category":"Miscellaneous"},{"id":1722,"name":"plants","purity":"sfw","category":"Plants"},{"id":328,"name":"mountains","purity":"sfw","category":"Nature"},{"id":20,"name":"river","purity":"sfw","category":"Landscapes"}],"image":"https://w.wallhaven.cc/full/9m/wallhaven-9mjoy1.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/9m/9mjoy1.jpg","views":842428,"colors":["#424153","#999999","#cccccc","#ffffff","#fdadc7"],"purity":"sfw","source":"https://www.artstation.com/artwork/EaDPkK","category":"anime","uploader":{"group":"User","username":"rootkit"},"favorites":5671,"file_size":15842713,"file_type":"image/png","created_at":"2022-08-12 12:11:18","resolution":"3840x2160"},"meta":{"timestamp":"2026-06-09T03:02:05.436Z","request_id":"312e725e-a2b4-41a6-b188-4f3ca792bf37"},"status":"ok","message":"Wallpaper retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sorts":["favorites","views","date_added","relevance","toplist"],"source":"Wallhaven public API (live, SFW-only)","service":"wallhaven-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/search":"Search wallpapers (q=, category=general|anime|people|all, sort=favorites|views|date_added|relevance, page).","GET /v1/wallpaper":"A wallpaper's detail + engagement + tags (id=9mjoy1)."},"categories":["all","general","anime","people"],"description":"Live Wallhaven community wallpaper data: search the SFW collection by keyword and category (general/anime/people) sorted by favourites, views or freshness, and read any wallpaper's engagement (favourites, views) with resolution, ratio, file type, colours and tags. SFW-only by design. Live, no key. Distinct from generic image/photo APIs — this is Wallhaven's own community wallpapers and engagement.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:06.018Z","request_id":"e0ab041e-f095-4c7b-bfdc-ba6cdddba229"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":120000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":630000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4900,"monthly_call_quota":3200000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wallhaven-api"}