{"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"},{"name":"Wallpapers"},{"name":"Tags"}],"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 wallpapers by keyword and category","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Keyword/tag","schema":{"type":"string"},"example":"nature"},{"name":"category","in":"query","required":false,"description":"general, anime, people or all","schema":{"type":"string"},"example":"all"},{"name":"sort","in":"query","required":false,"description":"favorites, views, date_added or 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's detail, engagement and tags","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"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"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Wallpapers"],"summary":"A random page of wallpapers for discovery","description":"","parameters":[{"name":"category","in":"query","required":false,"description":"general, anime, people or all","schema":{"type":"string"},"example":"all"},{"name":"page","in":"query","required":false,"description":"Page (1-50)","schema":{"type":"string"},"example":"1"},{"name":"seed","in":"query","required":false,"description":"6-char seed to page a stable random set","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"page":1,"seed":"YxxEpb","count":24,"category":"all","wallpapers":[{"id":"y8kjxk","url":"https://wallhaven.cc/w/y8kjxk","image":"https://w.wallhaven.cc/full/y8/wallhaven-y8kjxk.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/y8/y8kjxk.jpg","views":4065,"colors":["#000000","#424153","#996633","#663399","#cc6633"],"purity":"sfw","category":"general","favorites":55,"file_size":431500,"file_type":"image/jpeg","resolution":"1920x1080"},{"id":"4d3ml3","url":"https://wallhaven.cc/w/4d3ml3","image":"https://w.wallhaven.cc/full/4d/wallhaven-4d3ml3.jpg","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/4d/4d3ml3.jpg","views":3489,"colors":["#000000","#e7d8b1","#424153","#999999","#ffffff"],"purity":"sfw","category":"general","favorites":8,"file_size":212928,"file_type":"image/jpeg","resolution":"1440x900"},{"id":"yjl39k","url":"https://wallhaven.cc/w/yjl39k","image":"https://w.wallhaven.cc/full/yj/wallhaven-yjl39k.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/yj/yjl39k.jpg","views":8251,"colors":["#999999","#424153","#cccccc","#ffffff","#996633"],"purity":"sfw","category":"anime","favorites":45,"file_size":413355,"file_type":"image/jpeg","resolution":"1920x1080"},{"id":"kwjg31","url":"https://wallhaven.cc/w/kwjg31","image":"https://w.wallhaven.cc/full/kw/wallhaven-kwjg31.jpg","ratio":"0.67","thumb":"https://th.wallhaven.cc/small/kw/kwjg31.jpg","views":2761,"colors":["#999999","#424153","#cccccc","#996633","#000000"],"purity":"sfw","category":"people","favorites":24,"file_size":1162005,"file_type":"image/jpeg","resolution":"1200x1799"},{"id":"m9d1km","url":"https://wallhaven.cc/w/m9d1km","image":"https://w.wallhaven.cc/full/m9/wallhaven-m9d1km.jpg","ratio":"0.82","thumb":"https://th.wallhaven.cc/small/m9/m9d1km.jpg","views":1445,"colors":["#999999","#424153","#cccccc","#996633","#e7d8b1"],"purity":"sfw","category":"people","favorites":13,"file_size":1192043,"file_type":"image/jpeg","resolution":"3343x4096"},{"id":"r77gy1","url":"https://wallhaven.cc/w/r77gy1","image":"https://w.wallhaven.cc/full/r7/wallhaven-r77gy1.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/r7/r77gy1.jpg","views":4502,"colors":["#996633","#999999","#e7d8b1","#424153","#000000"],"purity":"sfw","category":"anime","favorites":21,"file_size":1995649,"file_type":"image/png","resolution":"1920x1080"},{"id":"4gxpoq","url":"https://wallhaven.cc/w/4gxpoq","image":"https://w.wallhaven.cc/full/4g/wallhaven-4gxpoq.jpg","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/4g/4gxpoq.jpg","views":18734,"colors":["#424153","#336600","#cccccc","#abbcda","#999999"],"purity":"sfw","category":"general","favorites":27,"file_size":593154,"file_type":"image/jpeg","resolution":"2560x1600"},{"id":"q6wqld","url":"https://wallhaven.cc/w/q6wqld","image":"https://w.wallhaven.cc/full/q6/wallhaven-q6wqld.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/q6/q6wqld.jpg","views":39540,"colors":["#000000","#424153","#663399","#996633","#999999"],"purity":"sfw","category":"general","favorites":126,"file_size":5028452,"file_type":"image/jpeg","resolution":"3840x2160"},{"id":"2kpory","url":"https://wallhaven.cc/w/2kpory","image":"https://w.wallhaven.cc/full/2k/wallhaven-2kpory.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/2k/2kpory.jpg","views":7155,"colors":["#e7d8b1","#999999","#660000","#ffff00","#abbcda"],"purity":"sfw","category":"general","favorites":11,"file_size":79579,"file_type":"image/jpeg","resolution":"1920x1080"},{"id":"nr9681","url":"https://wallhaven.cc/w/nr9681","image":"https://w.wallhaven.cc/full/nr/wallhaven-nr9681.jpg","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/nr/nr9681.jpg","views":3232,"colors":["#669900","#cccccc","#336600","#999999","#abbcda"],"purity":"sfw","category":"general","favorites":5,"file_size":501954,"file_type":"image/jpeg","resolution":"1920x1200"},{"id":"8x69wo","url":"https://wallhaven.cc/w/8x69wo","image":"https://w.wallhaven.cc/full/8x/wallhaven-8x69wo.jpg","ratio":"0.6","thumb":"https://th.wallhaven.cc/small/8x/8x69wo.jpg","views":1758,"colors":["#424153","#999999","#000000","#996633","#e7d8b1"],"purity":"sfw","category":"general","favorites":3,"file_size":352493,"file_type":"image/jpeg","resolution":"1224x2040"},{"id":"d5jdvo","url":"https://wallhaven.cc/w/d5jdvo","image":"https://w.wallhaven.cc/full/d5/wallhaven-d5jdvo.png","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/d5/d5jdvo.jpg","views":8479,"colors":["#000000","#cc3333","#424153","#993399","#663399"],"purity":"sfw","category":"general","favorites":7,"file_size":1765521,"file_type":"image/png","resolution":"1920x1200"},{"id":"0q1l6d","url":"https://wallhaven.cc/w/0q1l6d","image":"https://w.wallhaven.cc/full/0q/wallhaven-0q1l6d.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/0q/0q1l6d.jpg","views":3364,"colors":["#000000","#424153","#996633","#999999","#663300"],"purity":"sfw","category":"general","favorites":5,"file_size":629659,"file_type":"image/jpeg","resolution":"1920x1080"},{"id":"j8yjqw","url":"https://wallhaven.cc/w/j8yjqw","image":"https://w.wallhaven.cc/full/j8/wallhaven-j8yjqw.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/j8/j8yjqw.jpg","views":4723,"colors":["#424153","#cccc33","#996633","#999999","#e7d8b1"],"purity":"sfw","category":"anime","favorites":5,"file_size":2827100,"file_type":"image/png","resolution":"1920x1080"},{"id":"zxk82j","url":"https://wallhaven.cc/w/zxk82j","image":"https://w.wallhaven.cc/full/zx/wallhaven-zxk82j.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/zx/zxk82j.jpg","views":20992,"colors":["#999999","#424153","#000000","#660000","#ffff00"],"purity":"sfw","category":"general","favorites":89,"file_size":319019,"file_type":"image/jpeg","resolution":"1920x1080"},{"id":"k7xygd","url":"https://wallhaven.cc/w/k7xygd","image":"https://w.wallhaven.cc/full/k7/wallhaven-k7xygd.jpg","ratio":"1.58","thumb":"https://th.wallhaven.cc/small/k7/k7xygd.jpg","views":3495,"colors":["#424153","#999999","#cccccc","#abbcda","#ffffff"],"purity":"sfw","category":"general","favorites":26,"file_size":547035,"file_type":"image/jpeg","resolution":"2485x1576"},{"id":"2kgde6","url":"https://wallhaven.cc/w/2kgde6","image":"https://w.wallhaven.cc/full/2k/wallhaven-2kgde6.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/2k/2kgde6.jpg","views":2613,"colors":["#e7d8b1","#cc6633","#424153","#996633","#999999"],"purity":"sfw","category":"anime","favorites":5,"file_size":1762597,"file_type":"image/png","resolution":"1920x1080"},{"id":"0q8qyr","url":"https://wallhaven.cc/w/0q8qyr","image":"https://w.wallhaven.cc/full/0q/wallhaven-0q8qyr.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/0q/0q8qyr.jpg","views":2145,"colors":["#66cccc","#424153","#996633","#999999","#0099cc"],"purity":"sfw","category":"general","favorites":4,"file_size":908463,"file_type":"image/jpeg","resolution":"4000x2248"},{"id":"nkxmp6","url":"https://wallhaven.cc/w/nkxmp6","image":"https://w.wallhaven.cc/full/nk/wallhaven-nkxmp6.png","ratio":"1.6","thumb":"https://th.wallhaven.cc/small/nk/nkxmp6.jpg","views":3436,"colors":["#336600","#77cc33","#000000","#66cccc","#669900"],"purity":"sfw","category":"general","favorites":5,"file_size":4262437,"file_type":"image/png","resolution":"2560x1600"},{"id":"g81p8d","url":"https://wallhaven.cc/w/g81p8d","image":"https://w.wallhaven.cc/full/g8/wallhaven-g81p8d.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/g8/g81p8d.jpg","views":1382,"colors":["#424153","#000000","#660000","#999999","#663399"],"purity":"sfw","category":"general","favorites":3,"file_size":4140500,"file_type":"image/png","resolution":"1920x1080"},{"id":"vgp6p5","url":"https://wallhaven.cc/w/vgp6p5","image":"https://w.wallhaven.cc/full/vg/wallhaven-vgp6p5.png","ratio":"0.76","thumb":"https://th.wallhaven.cc/small/vg/vgp6p5.jpg","views":1823,"colors":["#999999","#e7d8b1","#cccccc","#ffffff","#424153"],"purity":"sfw","category":"anime","favorites":14,"file_size":2207512,"file_type":"image/png","resolution":"1370x1800"},{"id":"57xl87","url":"https://wallhaven.cc/w/57xl87","image":"https://w.wallhaven.cc/full/57/wallhaven-57xl87.jpg","ratio":"1.33","thumb":"https://th.wallhaven.cc/small/57/57xl87.jpg","views":738,"colors":["#66cccc","#424153","#ffffff","#abbcda","#333399"],"purity":"sfw","category":"anime","favorites":6,"file_size":987150,"file_type":"image/jpeg","resolution":"2047x1536"},{"id":"wydmq7","url":"https://wallhaven.cc/w/wydmq7","image":"https://w.wallhaven.cc/full/wy/wallhaven-wydmq7.jpg","ratio":"0.67","thumb":"https://th.wallhaven.cc/small/wy/wydmq7.jpg","views":13804,"colors":["#424153","#999999","#000000","#663399","#996633"],"purity":"sfw","category":"anime","favorites":148,"file_size":3981850,"file_type":"image/jpeg","resolution":"3042x4536"},{"id":"gj1yed","url":"https://wallhaven.cc/w/gj1yed","image":"https://w.wallhaven.cc/full/gj/wallhaven-gj1yed.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/gj/gj1yed.jpg","views":3515,"colors":["#424153","#999999","#cccccc","#996633","#abbcda"],"purity":"sfw","category":"anime","favorites":7,"file_size":120968,"file_type":"image/jpeg","resolution":"1920x1081"}]},"meta":{"timestamp":"2026-06-13T14:09:36.362Z","request_id":"fee999e4-29d8-4cce-8921-d02ec8072cca"},"status":"ok","message":"Random wallpapers 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/toplist":{"get":{"operationId":"get_v1_toplist","tags":["Wallpapers"],"summary":"Top wallpapers over a time range","description":"","parameters":[{"name":"range","in":"query","required":false,"description":"1d, 3d, 1w, 1M (default), 3M, 6M or 1y","schema":{"type":"string"},"example":"1M"},{"name":"category","in":"query","required":false,"description":"general, anime, people or all","schema":{"type":"string"},"example":"all"},{"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,"count":24,"range":"1M","total":2053,"category":"all","wallpapers":[{"id":"k82d26","url":"https://wallhaven.cc/w/k82d26","image":"https://w.wallhaven.cc/full/k8/wallhaven-k82d26.jpg","ratio":"1.5","thumb":"https://th.wallhaven.cc/small/k8/k82d26.jpg","views":32018,"colors":["#424153","#999999","#000000","#cccccc","#abbcda"],"purity":"sfw","category":"people","favorites":379,"file_size":2155314,"file_type":"image/jpeg","resolution":"4096x2731"},{"id":"w5m6yr","url":"https://wallhaven.cc/w/w5m6yr","image":"https://w.wallhaven.cc/full/w5/wallhaven-w5m6yr.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/w5/w5m6yr.jpg","views":21385,"colors":["#333399","#66cccc","#999999","#424153","#0066cc"],"purity":"sfw","category":"general","favorites":154,"file_size":1597629,"file_type":"image/jpeg","resolution":"3840x2160"},{"id":"yqv2wx","url":"https://wallhaven.cc/w/yqv2wx","image":"https://w.wallhaven.cc/full/yq/wallhaven-yqv2wx.jpg","ratio":"1.45","thumb":"https://th.wallhaven.cc/small/yq/yqv2wx.jpg","views":19463,"colors":["#424153","#000000","#999999","#663399","#abbcda"],"purity":"sfw","category":"general","favorites":208,"file_size":876938,"file_type":"image/jpeg","resolution":"4335x2990"},{"id":"6lw16w","url":"https://wallhaven.cc/w/6lw16w","image":"https://w.wallhaven.cc/full/6l/wallhaven-6lw16w.jpg","ratio":"0.56","thumb":"https://th.wallhaven.cc/small/6l/6lw16w.jpg","views":16319,"colors":["#424153","#996633","#999999","#000000","#663300"],"purity":"sfw","category":"general","favorites":147,"file_size":5132775,"file_type":"image/jpeg","resolution":"3978x7087"},{"id":"ml2wj8","url":"https://wallhaven.cc/w/ml2wj8","image":"https://w.wallhaven.cc/full/ml/wallhaven-ml2wj8.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/ml/ml2wj8.jpg","views":12596,"colors":["#424153","#000000","#336600","#666600","#999999"],"purity":"sfw","category":"general","favorites":213,"file_size":7852454,"file_type":"image/jpeg","resolution":"3840x2160"},{"id":"jev1dy","url":"https://wallhaven.cc/w/jev1dy","image":"https://w.wallhaven.cc/full/je/wallhaven-jev1dy.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/je/jev1dy.jpg","views":10690,"colors":["#000000","#424153","#66cccc","#996633","#999999"],"purity":"sfw","category":"general","favorites":119,"file_size":3151216,"file_type":"image/png","resolution":"1920x1080"},{"id":"9or96k","url":"https://wallhaven.cc/w/9or96k","image":"https://w.wallhaven.cc/full/9o/wallhaven-9or96k.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/9o/9or96k.jpg","views":9083,"colors":["#424153","#333399","#cccccc","#996633","#cccc33"],"purity":"sfw","category":"general","favorites":156,"file_size":3355956,"file_type":"image/jpeg","resolution":"3840x2160"},{"id":"d8wo8m","url":"https://wallhaven.cc/w/d8wo8m","image":"https://w.wallhaven.cc/full/d8/wallhaven-d8wo8m.jpg","ratio":"1.51","thumb":"https://th.wallhaven.cc/small/d8/d8wo8m.jpg","views":8797,"colors":["#424153","#000000","#663300","#996633","#999999"],"purity":"sfw","category":"general","favorites":91,"file_size":4081798,"file_type":"image/jpeg","resolution":"4000x2653"},{"id":"d8wvxo","url":"https://wallhaven.cc/w/d8wvxo","image":"https://w.wallhaven.cc/full/d8/wallhaven-d8wvxo.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/d8/d8wvxo.jpg","views":8532,"colors":["#000000","#424153","#999999","#cccccc","#663399"],"purity":"sfw","category":"general","favorites":95,"file_size":832619,"file_type":"image/jpeg","resolution":"2560x1440"},{"id":"qrlg1r","url":"https://wallhaven.cc/w/qrlg1r","image":"https://w.wallhaven.cc/full/qr/wallhaven-qrlg1r.jpg","ratio":"1.77","thumb":"https://th.wallhaven.cc/small/qr/qrlg1r.jpg","views":8378,"colors":["#663300","#abbcda","#66cccc","#424153","#996633"],"purity":"sfw","category":"general","favorites":166,"file_size":17533628,"file_type":"image/jpeg","resolution":"6144x3463"},{"id":"gw22el","url":"https://wallhaven.cc/w/gw22el","image":"https://w.wallhaven.cc/full/gw/wallhaven-gw22el.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/gw/gw22el.jpg","views":8125,"colors":["#000000","#424153","#999999","#996633","#e7d8b1"],"purity":"sfw","category":"general","favorites":92,"file_size":1622289,"file_type":"image/jpeg","resolution":"3753x2111"},{"id":"d8wk2g","url":"https://wallhaven.cc/w/d8wk2g","image":"https://w.wallhaven.cc/full/d8/wallhaven-d8wk2g.jpg","ratio":"2.75","thumb":"https://th.wallhaven.cc/small/d8/d8wk2g.jpg","views":8071,"colors":["#000000","#424153","#66cccc","#333399","#0099cc"],"purity":"sfw","category":"general","favorites":50,"file_size":5097888,"file_type":"image/jpeg","resolution":"5000x1820"},{"id":"xepjgv","url":"https://wallhaven.cc/w/xepjgv","image":"https://w.wallhaven.cc/full/xe/wallhaven-xepjgv.jpg","ratio":"1.33","thumb":"https://th.wallhaven.cc/small/xe/xepjgv.jpg","views":7744,"colors":["#999999","#663300","#424153","#996633","#000000"],"purity":"sfw","category":"anime","favorites":109,"file_size":14183302,"file_type":"image/jpeg","resolution":"4000x3000"},{"id":"e8wejo","url":"https://wallhaven.cc/w/e8wejo","image":"https://w.wallhaven.cc/full/e8/wallhaven-e8wejo.jpg","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/e8/e8wejo.jpg","views":7694,"colors":["#424153","#abbcda","#000000","#cccccc","#333399"],"purity":"sfw","category":"general","favorites":128,"file_size":7912884,"file_type":"image/jpeg","resolution":"5120x2880"},{"id":"jevdxm","url":"https://wallhaven.cc/w/jevdxm","image":"https://w.wallhaven.cc/full/je/wallhaven-jevdxm.png","ratio":"0.56","thumb":"https://th.wallhaven.cc/small/je/jevdxm.jpg","views":7425,"colors":["#424153","#ffffff","#999999","#000000","#cccccc"],"purity":"sfw","category":"anime","favorites":87,"file_size":1685328,"file_type":"image/png","resolution":"850x1525"},{"id":"xepp7d","url":"https://wallhaven.cc/w/xepp7d","image":"https://w.wallhaven.cc/full/xe/wallhaven-xepp7d.jpg","ratio":"1.88","thumb":"https://th.wallhaven.cc/small/xe/xepp7d.jpg","views":7278,"colors":["#424153","#e7d8b1","#999999","#fdadc7","#cccccc"],"purity":"sfw","category":"general","favorites":93,"file_size":132632,"file_type":"image/jpeg","resolution":"2540x1350"},{"id":"yqv5zd","url":"https://wallhaven.cc/w/yqv5zd","image":"https://w.wallhaven.cc/full/yq/wallhaven-yqv5zd.jpg","ratio":"1.55","thumb":"https://th.wallhaven.cc/small/yq/yqv5zd.jpg","views":7172,"colors":["#000000","#424153","#999999","#996633","#333399"],"purity":"sfw","category":"general","favorites":60,"file_size":982423,"file_type":"image/jpeg","resolution":"4000x2584"},{"id":"k82231","url":"https://wallhaven.cc/w/k82231","image":"https://w.wallhaven.cc/full/k8/wallhaven-k82231.png","ratio":"1","thumb":"https://th.wallhaven.cc/small/k8/k82231.jpg","views":7182,"colors":["#000000","#424153","#333399","#66cccc","#999999"],"purity":"sfw","category":"general","favorites":91,"file_size":11006520,"file_type":"image/png","resolution":"3636x3636"},{"id":"w5m62x","url":"https://wallhaven.cc/w/w5m62x","image":"https://w.wallhaven.cc/full/w5/wallhaven-w5m62x.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/w5/w5m62x.jpg","views":7134,"colors":["#424153","#000000","#999999","#333399","#cc3333"],"purity":"sfw","category":"anime","favorites":181,"file_size":1167091,"file_type":"image/png","resolution":"1920x1080"},{"id":"poygo9","url":"https://wallhaven.cc/w/poygo9","image":"https://w.wallhaven.cc/full/po/wallhaven-poygo9.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/po/poygo9.jpg","views":6823,"colors":["#000000","#663300","#424153","#996633","#660000"],"purity":"sfw","category":"general","favorites":99,"file_size":2215553,"file_type":"image/png","resolution":"1920x1080"},{"id":"ml2wvm","url":"https://wallhaven.cc/w/ml2wvm","image":"https://w.wallhaven.cc/full/ml/wallhaven-ml2wvm.png","ratio":"3.56","thumb":"https://th.wallhaven.cc/small/ml/ml2wvm.jpg","views":6749,"colors":["#424153","#ff9900","#999999","#cc3333","#996633"],"purity":"sfw","category":"general","favorites":36,"file_size":879853,"file_type":"image/png","resolution":"5120x1440"},{"id":"w5mlkq","url":"https://wallhaven.cc/w/w5mlkq","image":"https://w.wallhaven.cc/full/w5/wallhaven-w5mlkq.png","ratio":"1.48","thumb":"https://th.wallhaven.cc/small/w5/w5mlkq.jpg","views":6627,"colors":["#e7d8b1","#999999","#996633","#cc6633","#ffffff"],"purity":"sfw","category":"anime","favorites":168,"file_size":20051180,"file_type":"image/png","resolution":"3400x2300"},{"id":"w5mdxp","url":"https://wallhaven.cc/w/w5mdxp","image":"https://w.wallhaven.cc/full/w5/wallhaven-w5mdxp.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/w5/w5mdxp.jpg","views":6509,"colors":["#999999","#e7d8b1","#cccccc","#996633","#424153"],"purity":"sfw","category":"general","favorites":97,"file_size":8073149,"file_type":"image/png","resolution":"3840x2160"},{"id":"e8w2jk","url":"https://wallhaven.cc/w/e8w2jk","image":"https://w.wallhaven.cc/full/e8/wallhaven-e8w2jk.png","ratio":"1.78","thumb":"https://th.wallhaven.cc/small/e8/e8w2jk.jpg","views":6477,"colors":["#424153","#ea4c88","#cc6633","#996633","#993399"],"purity":"sfw","category":"general","favorites":79,"file_size":235057,"file_type":"image/png","resolution":"3840x2160"}]},"meta":{"timestamp":"2026-06-13T14:09:36.740Z","request_id":"a4d07cde-749f-4c34-bdf2-7da2b361e998"},"status":"ok","message":"Toplist 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/tag":{"get":{"operationId":"get_v1_tag","tags":["Tags"],"summary":"A tag's metadata (name, alias, category)","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric tag id","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":1,"name":"anime","alias":"Japanese cartoon, 動漫","purity":"sfw","category":"Anime & Manga","created_at":"2014-02-02 10:44:37","category_id":1},"meta":{"timestamp":"2026-06-13T14:09:36.944Z","request_id":"b97a4847-a28e-450c-9a4d-7d3327fa3616"},"status":"ok","message":"Tag 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"}}}}},"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"}