{"openapi":"3.1.0","info":{"title":"Danbooru API","version":"1.0.0","description":"Live post, tag and ranking data from Danbooru, the large community anime-art imageboard, via its public API. Danbooru is built around a deep tag taxonomy — every image is tagged by artist, character, copyright (the source series) and general descriptors. Search images by tag and get each post's score, favourite count, rating, dimensions and its split tag sets. Read a single post in full. Search the tag database itself, returning each tag's post count and category — the metadata that powers booru search. Get the most-favourited posts of a given day, the site's trending art. Live, no key, nothing stored; to keep results work-safe, only general- and sensitive-rated posts are returned. Distinct from 4chan and other imageboard APIs — this is Danbooru's tagged-art database and its rankings. Perfect for art-discovery, tagging and community apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/danbooru-api","description":"oanor gateway"}],"tags":[{"name":"Posts"},{"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/popular":{"get":{"operationId":"get_v1_popular","tags":["Posts"],"summary":"Most-favourited posts of a day","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-06-01"},{"name":"scale","in":"query","required":false,"description":"day, week or month","schema":{"type":"string"},"example":"day"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-06-01","count":10,"posts":[{"id":11500732,"score":331,"artist":["vitaminechan"],"rating":"s","file_url":"https://cdn.donmai.us/original/33/4e/334e19279933437764c2864a2e7cc903.jpg","copyright":["genshin_impact"],"fav_count":307,"characters":["sandrone_(genshin_impact)"],"created_at":"2026-06-01T15:59:21.690-04:00","image_width":1797,"image_height":4006},{"id":11496847,"score":327,"artist":["meekohopanes"],"rating":"s","file_url":"https://cdn.donmai.us/original/db/46/db46b315a721756a514e488def4fc40c.jpg","copyright":["no_game_no_life"],"fav_count":303,"characters":["shiro_(no_game_no_life)"],"created_at":"2026-06-01T03:25:17.562-04:00","image_width":3162,"image_height":2093},{"id":11496472,"score":245,"artist":["rkgktomato"],"rating":"s","file_url":"https://cdn.donmai.us/original/44/5d/445d939532f8cbc40df774932afa7b91.png","copyright":["mushoku_tensei"],"fav_count":218,"characters":["eris_greyrat"],"created_at":"2026-06-01T01:50:24.886-04:00","image_width":2240,"image_height":3541},{"id":11499335,"score":243,"artist":[],"rating":"s","file_url":"https://cdn.donmai.us/original/d4/b6/d4b6c517c5e0326289a77dc468652596.jpg","copyright":["azur_lane"],"fav_count":226,"characters":["cleopatra_(azur_lane)","cleopatra_(stars_and_roses)_(azur_lane)","dido_(azur_lane)"],"created_at":"2026-06-01T12:01:01.740-04:00","image_width":3627,"image_height":2040},{"id":11500321,"score":219,"artist":["secon"],"rating":"s","file_url":"https://cdn.donmai.us/original/24/06/24064f1c1e30f2a29df7386292377756.jpg","copyright":["azur_lane"],"fav_count":205,"characters":["baltimore_(azur_lane)","baltimore_(finish_line_flagbearer)_(azur_lane)"],"created_at":"2026-06-01T14:34:26.331-04:00","image_width":2273,"image_height":3410},{"id":11496741,"score":214,"artist":["pegasusviv"],"rating":"s","file_url":"https://cdn.donmai.us/original/32/82/3282134d2481cdac3362b9c6bf32ef28.png","copyright":["arknights","arknights:_endfield"],"fav_count":205,"characters":["rossi_(arknights)"],"created_at":"2026-06-01T03:03:00.803-04:00","image_width":2894,"image_height":4093},{"id":11497663,"score":191,"artist":["gongbangmanchi_(daisy_cutter)"],"rating":"s","file_url":"https://cdn.donmai.us/original/db/be/dbbe984c2b381fe65510277a42789ca7.jpg","copyright":["arknights"],"fav_count":174,"characters":["lappland_(arknights)","texas_(arknights)"],"created_at":"2026-06-01T06:51:17.912-04:00","image_width":3000,"image_height":3400},{"id":11500677,"score":176,"artist":["chokopaii"],"rating":"s","file_url":"https://cdn.donmai.us/original/20/e0/20e0a86a40b6f4cdf11b5ddccaa9ac54.jpg","copyright":["zenless_zone_zero"],"fav_count":165,"characters":["velina_airgid"],"created_at":"2026-06-01T15:45:04.944-04:00","image_width":1401,"image_height":2048},{"id":11496330,"score":172,"artist":["ir_who"],"rating":"s","file_url":"https://cdn.donmai.us/original/b6/2e/b62e496f2ff2bb12f7a13337a036db36.png","copyright":["zenless_zone_zero"],"fav_count":155,"characters":["hoshimi_miyabi","hoshimi_miyabi_(dignified_blossom)"],"created_at":"2026-06-01T01:08:17.556-04:00","image_width":4477,"image_height":7594},{"id":11501702,"score":151,"artist":["yuzureei"],"rating":"s","file_url":"https://cdn.donmai.us/original/6f/ff/6fffddc3a38edaa3936df3095714a690.jpg","copyright":["hololive","hololive_english"],"fav_count":136,"characters":["shiori_novella","shiori_novella_(pajamas)"],"created_at":"2026-06-01T19:53:55.635-04:00","image_width":1252,"image_height":1320}],"scale":"day","source":"Danbooru"},"meta":{"timestamp":"2026-06-10T14:02:17.048Z","request_id":"37e94df6-6ddf-4af6-a3b1-892f776cdd1e"},"status":"ok","message":"Popular posts 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/post":{"get":{"operationId":"get_v1_post","tags":["Posts"],"summary":"A single post in full","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Danbooru post id","schema":{"type":"string"},"example":"11556356"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":11556356,"score":0,"artist":["mofinngram"],"rating":"g","source":"Danbooru","file_url":"https://cdn.donmai.us/original/ac/e2/ace21bcd9b493c815fb9d8c2431d4a7c.jpg","up_score":0,"copyright":["pokemon"],"fav_count":0,"characters":["conkeldurr","gurdurr","timburr"],"created_at":"2026-06-10T04:31:01.852-04:00","down_score":0,"image_width":1440,"general_tags":["alternate_color","black_eyes","bright_pupils","carrying","closed_mouth","evolutionary_line","holding","muscular","open_mouth","pokemon_(creature)","pokemon_focus","red_nose","shiny_and_normal","shiny_pokemon","steel_beam","veins","white_pupils","wooden_beam"],"image_height":1800},"meta":{"timestamp":"2026-06-10T14:02:17.312Z","request_id":"e9b94dd9-34a9-46f1-a06f-a793603f8a12"},"status":"ok","message":"Post 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/posts":{"get":{"operationId":"get_v1_posts","tags":["Posts"],"summary":"Search anime-art posts by tag","description":"","parameters":[{"name":"tags","in":"query","required":true,"description":"Up to 2 tags","schema":{"type":"string"},"example":"cat_girl"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tags":"cat_girl","count":20,"posts":[{"id":11557814,"score":0,"artist":["tatsuyoshi_(zawahomura)"],"rating":"g","file_url":"https://cdn.donmai.us/original/4c/96/4c964833d4e2b6e2f15a7172f931005c.jpg","copyright":["indie_virtual_youtuber"],"fav_count":0,"characters":["yuuki_sakuna"],"created_at":"2026-06-10T09:34:39.797-04:00","image_width":1473,"image_height":2069},{"id":11557789,"score":0,"artist":["luxjii"],"rating":"g","file_url":"https://cdn.donmai.us/original/34/e0/34e02d5c5b799b90944ea924a46bec95.jpg","copyright":["night_in_the_woods"],"fav_count":0,"characters":["mae_borowski"],"created_at":"2026-06-10T09:30:46.140-04:00","image_width":1247,"image_height":1962},{"id":11557746,"score":1,"artist":["tsunakawa"],"rating":"s","file_url":"https://cdn.donmai.us/original/40/7f/407fd4630fb7284dbb6a6c35e993d104.jpg","copyright":["hololive"],"fav_count":1,"characters":["nekomata_okayu","nekomata_okayu_(poisonya_syndrome)"],"created_at":"2026-06-10T09:22:52.330-04:00","image_width":717,"image_height":1000},{"id":11557392,"score":1,"artist":["kaiwan_(kaiwan_zhang)"],"rating":"g","file_url":"https://cdn.donmai.us/original/31/ea/31ea73fa3cef32fb616d6fe8af079254.jpg","copyright":["original"],"fav_count":1,"characters":[],"created_at":"2026-06-10T08:21:05.252-04:00","image_width":1418,"image_height":2048},{"id":11557312,"score":0,"artist":["atelier-moo"],"rating":"s","file_url":"https://cdn.donmai.us/original/ea/18/ea18acddac12097e36da4dfb1e5de336.png","copyright":["wizards_symphony"],"fav_count":0,"characters":["eleick_meola","feline_sora","kurenai_shisui"],"created_at":"2026-06-10T08:04:29.852-04:00","image_width":1860,"image_height":1040},{"id":11557306,"score":3,"artist":["nshima000"],"rating":"g","file_url":"https://cdn.donmai.us/original/98/b5/98b51147de789472a895752c5275871c.jpg","copyright":["blue_archive"],"fav_count":2,"characters":["akira_(blue_archive)"],"created_at":"2026-06-10T08:02:54.992-04:00","image_width":2894,"image_height":4093},{"id":11557284,"score":4,"artist":["ki_no_nekko"],"rating":"s","file_url":"https://cdn.donmai.us/original/fe/de/fedef8d025a6dd77e303a5c278e15989.png","copyright":["blue_archive"],"fav_count":4,"characters":["rena_(blue_archive)"],"created_at":"2026-06-10T07:58:48.051-04:00","image_width":1654,"image_height":2756},{"id":11557233,"score":0,"artist":["poxiao_buff"],"rating":"g","file_url":"https://cdn.donmai.us/original/dd/39/dd398e4816122a35e2c8dd74e8e480db.png","copyright":["original"],"fav_count":0,"characters":[],"created_at":"2026-06-10T07:48:36.583-04:00","image_width":2480,"image_height":3508},{"id":11557208,"score":0,"artist":["atelier-moo"],"rating":"s","file_url":"https://cdn.donmai.us/original/52/aa/52aa8444615eb7ca3a61befbc89b5bea.png","copyright":["wizards_symphony"],"fav_count":0,"characters":["alto_travers","feline_sora"],"created_at":"2026-06-10T07:42:55.242-04:00","image_width":2020,"image_height":1290},{"id":11557178,"score":0,"artist":["ingoagame"],"rating":"g","file_url":"https://cdn.donmai.us/original/9e/fa/9efab0437c3d8ced0ba3b748c786c9de.jpg","copyright":["tayutau_koi_no_chirigiwa_ni"],"fav_count":0,"characters":["emma_grace_rosenthal","jougasaki_suzuran"],"created_at":"2026-06-10T07:36:21.732-04:00","image_width":3847,"image_height":2741},{"id":11557014,"score":9,"artist":["far_side"],"rating":"s","file_url":"https://cdn.donmai.us/original/17/ef/17efb3c974640983b08bb29d7f43695a.jpg","copyright":["zenless_zone_zero"],"fav_count":7,"characters":["nekomiya_mana"],"created_at":"2026-06-10T07:00:28.026-04:00","image_width":2800,"image_height":1600},{"id":11556987,"score":4,"artist":["saint_laurent_paris"],"rating":"s","file_url":"https://cdn.donmai.us/original/4e/3b/4e3bd9c69e5bb8b89ef970bed49bbaad.png","copyright":["honkai:_star_rail","honkai_(series)"],"fav_count":4,"characters":["cipher_(honkai:_star_rail)"],"created_at":"2026-06-10T06:54:59.662-04:00","image_width":1080,"image_height":2122},{"id":11556978,"score":4,"artist":["chiu538"],"rating":"g","file_url":"https://cdn.donmai.us/original/8a/25/8a250a6f9e6d85b43de31e28429b4b5a.jpg","copyright":["blue_archive"],"fav_count":3,"characters":["mari_(blue_archive)","mari_(idol)_(blue_archive)"],"created_at":"2026-06-10T06:52:10.581-04:00","image_width":3371,"image_height":4493},{"id":11556858,"score":3,"artist":["sakuemon"],"rating":"g","file_url":"https://cdn.donmai.us/original/8c/db/8cdb468b58a007a2fe9565912001ca4d.mp4","copyright":["tsukihime","tsukihime_(remake)"],"fav_count":2,"characters":["arcueid_brunestud"],"created_at":"2026-06-10T06:22:49.208-04:00","image_width":800,"image_height":600},{"id":11556722,"score":10,"artist":["2091966"],"rating":"g","file_url":"https://cdn.donmai.us/original/09/db/09dba78cf1b9336fe5e84cdb56329ea3.png","copyright":["touhou"],"fav_count":9,"characters":["cirno"],"created_at":"2026-06-10T05:47:26.586-04:00","image_width":2048,"image_height":2048},{"id":11556640,"score":6,"artist":["to_ko"],"rating":"s","file_url":"https://cdn.donmai.us/original/8d/db/8ddb553d9c6714fdd2ba3d76c8c1aa7a.webp","copyright":["genshin_impact"],"fav_count":6,"characters":["columbina_(genshin_impact)","sandrone_(genshin_impact)"],"created_at":"2026-06-10T05:31:49.408-04:00","image_width":1560,"image_height":1841},{"id":11556562,"score":1,"artist":["moroqoishii"],"rating":"g","file_url":"https://cdn.donmai.us/original/36/45/3645144fc37cbe3d38bbfe680595e306.png","copyright":["original"],"fav_count":1,"characters":[],"created_at":"2026-06-10T05:18:06.845-04:00","image_width":2000,"image_height":4000},{"id":11556554,"score":16,"artist":["hongshao_tu_tou_bei_bei_xiang"],"rating":"s","file_url":"https://cdn.donmai.us/original/80/40/80402522f61b460352c07c1598f502d5.jpg","copyright":["blue_archive"],"fav_count":15,"characters":["kikyou_(blue_archive)","kikyou_(swimsuit)_(blue_archive)"],"created_at":"2026-06-10T05:16:37.222-04:00","image_width":1314,"image_height":2183},{"id":11556500,"score":18,"artist":["hongshao_tu_tou_bei_bei_xiang"],"rating":"s","file_url":"https://cdn.donmai.us/original/35/4b/354b48dec388c4263f8336a4ac3c7f65.jpg","copyright":["blue_archive"],"fav_count":15,"characters":["doodle_sensei_(blue_archive)","kikyou_(blue_archive)","sensei_(blue_archive)"],"created_at":"2026-06-10T05:05:37.333-04:00","image_width":1769,"image_height":2652},{"id":11556494,"score":1,"artist":["monyami"],"rating":"g","file_url":"https://cdn.donmai.us/original/57/ac/57ac2de9859ccbcf987b47e47c226d1c.png","copyright":["trickcal"],"fav_count":1,"characters":["butter_(trickcal)","kommy_(trickcal)"],"created_at":"2026-06-10T05:04:05.130-04:00","image_width":2000,"image_height":1000}],"source":"Danbooru"},"meta":{"timestamp":"2026-06-10T14:02:17.749Z","request_id":"6a679576-91b0-4075-9b66-748427bc8054"},"status":"ok","message":"Posts 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/tags":{"get":{"operationId":"get_v1_tags","tags":["Tags"],"summary":"Search the tag database","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Tag query","schema":{"type":"string"},"example":"cat"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tags":[{"name":"cat_ears","category":"general","post_count":388263},{"name":"cat_tail","category":"general","post_count":212534},{"name":"cat_girl","category":"general","post_count":150241},{"name":"cat","category":"general","post_count":112702},{"name":"cat_boy","category":"general","post_count":17758},{"name":"cat_ear_headphones","category":"general","post_count":11067},{"name":"cat_hair_ornament","category":"general","post_count":9324},{"name":"cat_paws","category":"general","post_count":7508},{"name":"cat_hood","category":"general","post_count":7473},{"name":"cat_cutout","category":"general","post_count":7359},{"name":"cat_lingerie","category":"general","post_count":6844},{"name":"cat_hat","category":"general","post_count":6106},{"name":"cat_print","category":"general","post_count":5159},{"name":"cat_ear_hairband","category":"general","post_count":4462},{"name":"cat_ear_panties","category":"general","post_count":3857},{"name":"caterpillar_tracks","category":"general","post_count":3550},{"name":"cat_day","category":"general","post_count":2965},{"name":"cat_on_head","category":"general","post_count":2905},{"name":"cat_teaser","category":"general","post_count":2835},{"name":"cat_ear_legwear","category":"general","post_count":1874}],"count":20,"query":"cat","source":"Danbooru"},"meta":{"timestamp":"2026-06-10T14:02:17.996Z","request_id":"8d38b105-510b-43e2-879d-67e3c215c561"},"status":"ok","message":"Tags 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":13000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":176000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":945000,"rps_limit":18,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4800,"monthly_call_quota":5450000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/danbooru-api"}