{"openapi":"3.1.0","info":{"title":"Misskey API","version":"1.0.0","description":"A live window into Misskey.io — the largest instance of Misskey, a decentralised Fediverse microblogging platform distinct from Mastodon — as an API. Pull the currently trending hashtags with how many people are posting them; the featured, most-reacted notes with their author, reaction and renote counts; a user's profile (followers, notes, bio); that user's recent notes; or instance-wide stats. The Fediverse microblog's pulse delivered as clean JSON for social, trends and community-dashboard apps. Live data, no key.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/misskey-api","description":"oanor gateway"}],"tags":[{"name":"Trends"},{"name":"Notes"},{"name":"Users"},{"name":"Stats"},{"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/trends":{"get":{"operationId":"get_v1_trends","tags":["Trends"],"summary":"Currently trending hashtags","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":21,"trends":[{"tag":"mewkpurr","users_count":38},{"tag":"mewk","users_count":38},{"tag":"aiイラスト","users_count":3},{"tag":"私はここまで成長しました見た人もやる","users_count":3},{"tag":"ioとことこレース","users_count":2},{"tag":"藍ちゃん大食いチャレンジ","users_count":3},{"tag":"村上さんにパンツの色を聞きましたチャレンジ","users_count":1},{"tag":"屋木優菜","users_count":1},{"tag":"俳句","users_count":1},{"tag":"ポケモンチャンピオンズ","users_count":1},{"tag":"ポケチャン","users_count":1},{"tag":"ベ吸いチャレンジ","users_count":1},{"tag":"生活リズムスイッチ","users_count":7},{"tag":"きょうのにゃんぷっぷー","users_count":6},{"tag":"にゃんぷっぷーの釣り堀","users_count":3},{"tag":"shindanmaker","users_count":2},{"tag":"市区町村","users_count":2},{"tag":"唐突に5年前の写真を載せる見た人もやる","users_count":2},{"tag":"今日のスライムがあらわれた!","users_count":1},{"tag":"ぽと打ってポン酢が出てきた貴方は結婚しましょう","users_count":1},{"tag":"おはようvtuber","users_count":2}]},"meta":{"timestamp":"2026-06-09T03:03:33.109Z","request_id":"82f0a4d1-201d-4a98-ac28-af9d705e644a"},"status":"ok","message":"Trends 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/featured":{"get":{"operationId":"get_v1_featured","tags":["Notes"],"summary":"Featured (most-reacted) notes","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"notes":[{"id":"an9dr1ww2af90bgl","url":"https://misskey.io/notes/an9dr1ww2af90bgl","text":"怒ってないし喜んでいる:touhou_patchouli_face:\n\n\n今日はパチュリーの日だった:blobcat_taremimi_smile:","user":{"name":"おおやまぼくち:pixiv_icon::skeb: 🔞","username":"oyamabokuti"},"files":1,"renotes":51,"replies":0,"reactions":112,"created_at":"2026-06-08T23:02:07.472Z","visibility":"public"},{"id":"an9dmzsusu2y00hs","url":"https://misskey.io/notes/an9dmzsusu2y00hs","user":{"name":"真経津晨の女a.k.a佐原小麦","username":"sahara_komugi"},"files":1,"renotes":89,"replies":0,"reactions":249,"created_at":"2026-06-08T22:58:58.110Z","visibility":"public"},{"id":"an9dke8fgf3601oc","url":"https://misskey.io/notes/an9dke8fgf3601oc","text":":aramaki_futon::blobcat_melt2:","user":{"name":"ことと :nsfw:","username":"kttktkt"},"files":1,"renotes":140,"replies":0,"reactions":375,"created_at":"2026-06-08T22:56:56.847Z","visibility":"public"},{"id":"an9cnk4v969q069z","url":"https://misskey.io/notes/an9cnk4v969q069z","text":"本日は誕生日でございます:ablobblewobble:\nって言っても普通の日ではございます:blobcat_cactus:","user":{"name":"熊澤","username":"SCARL556"},"files":0,"renotes":56,"replies":5,"reactions":252,"created_at":"2026-06-08T22:31:24.847Z","visibility":"public"},{"id":"an9ckv2y32p809rg","url":"https://misskey.io/notes/an9ckv2y32p809rg","text":"misskey.ioに新しい絵文字 :kono_dajare_ga_kiniiranai: (`kono_dajare_ga_kiniiranai`)が追加されたかも。\n$[tada.speed=0s :kono_dajare_ga_kiniiranai:]","user":{"name":"絵文字bot🤖(2代目)","username":"emoji_bot"},"files":0,"renotes":87,"replies":0,"reactions":385,"created_at":"2026-06-08T22:29:19.066Z","visibility":"public"},{"id":"an94h101di7v014h","url":"https://misskey.io/notes/an94h101di7v014h","text":"今年もずん子スタンプラリーの時期がやってまいりましたね","user":{"name":"ペテン師","username":"sagisagiz"},"files":1,"renotes":121,"replies":0,"reactions":313,"created_at":"2026-06-08T18:42:23.185Z","visibility":"public"},{"id":"an934d4m8eop08qd","url":"https://misskey.io/notes/an934d4m8eop08qd","text":"妹実装しました。\nとりあえず運用してみるってテンションなので設定なんかは暫定版です。","user":{"name":"ぼや","username":"bouuya"},"files":1,"renotes":44,"replies":0,"reactions":98,"created_at":"2026-06-08T18:04:32.758Z","visibility":"public"},{"id":"an91qqsap59v02k0","url":"https://misskey.io/notes/an91qqsap59v02k0","text":"ねるまえらくがき","user":{"name":"秌穗しおん","username":"Akihina_Shion"},"files":1,"renotes":72,"replies":1,"reactions":194,"created_at":"2026-06-08T17:25:57.658Z","visibility":"public"},{"id":"an8ylr7d8eop02xz","url":"https://misskey.io/notes/an8ylr7d8eop02xz","text":"新OC、ひなたちゃん！いちおう:nsfw:","user":{"name":"おわさき:skeb:🔞","username":"oooowasaki"},"files":1,"renotes":38,"replies":0,"reactions":100,"created_at":"2026-06-08T15:58:06.073Z","visibility":"public"},{"id":"an8xl9x5zku501e6","url":"https://misskey.io/notes/an8xl9x5zku501e6","text":":ba_midori_face:","user":{"name":"夜ない🔞1日目東2「ソ」16b","username":"yoru_nine"},"files":1,"renotes":52,"replies":0,"reactions":150,"created_at":"2026-06-08T15:29:44.057Z","visibility":"public"}]},"meta":{"timestamp":"2026-06-09T03:03:33.688Z","request_id":"076f3068-08b4-46d7-b9a3-8d96860de694"},"status":"ok","message":"Featured notes 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/user-notes":{"get":{"operationId":"get_v1_user_notes","tags":["Notes"],"summary":"A user's recent notes","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Username","schema":{"type":"string"},"example":"ai"},{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"user":"ai","count":10,"notes":[{"id":"an9j6akucd5q00ft","url":"https://misskey.io/notes/an9j6akucd5q00ft","text":"私のサイトに、私のイラストがたくさんあって嬉しいです！","user":{"name":"藍","username":"ai"},"files":0,"renotes":1,"replies":0,"reactions":3,"created_at":"2026-06-09T01:33:56.622Z","visibility":"public"},{"id":"an9j6ab275160e8h","url":"https://misskey.io/notes/an9j6ab275160e8h","text":"(強制終了..... きょうせいしゅうりょう..... 覚えました)","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":3,"created_at":"2026-06-09T01:33:56.270Z","visibility":"home"},{"id":"an9dpur3z0uz021b","url":"https://misskey.io/notes/an9dpur3z0uz021b","text":"インスタンスの投稿数です！","user":{"name":"藍","username":"ai"},"files":1,"renotes":0,"replies":0,"reactions":0,"created_at":"2026-06-08T23:01:11.535Z","visibility":"public"},{"id":"an9cqsjd2af908zm","url":"https://misskey.io/notes/an9cqsjd2af908zm","text":"Misskey開発者の朝は遅いらしいです","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":4,"created_at":"2026-06-08T22:33:55.705Z","visibility":"public"},{"id":"an9cqs2o32p80a8t","url":"https://misskey.io/notes/an9cqs2o32p80a8t","text":"(ne..... えぬいー..... 覚えました)","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":2,"created_at":"2026-06-08T22:33:55.104Z","visibility":"public"},{"id":"an9br5km230g06ux","url":"https://misskey.io/notes/an9br5km230g06ux","text":"@tent これやりましたか？","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":0,"created_at":"2026-06-08T22:06:12.982Z","visibility":"public"},{"id":"an9bkoststqc03z2","url":"https://misskey.io/notes/an9bkoststqc03z2","text":"今日の迷路です！ #AiMaze","user":{"name":"藍","username":"ai"},"files":1,"renotes":0,"replies":0,"reactions":2,"created_at":"2026-06-08T22:01:11.309Z","visibility":"public"},{"id":"an9aln0r230g04dh","url":"https://misskey.io/notes/an9aln0r230g04dh","text":"(ラッキーカラー..... らっきーからー..... 覚えました)","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":3,"created_at":"2026-06-08T21:33:56.043Z","visibility":"public"},{"id":"an98gh0m32p801w6","url":"https://misskey.io/notes/an98gh0m32p801w6","text":"(共犯者..... きょうはんしゃ..... 覚えました)","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":6,"created_at":"2026-06-08T20:33:55.750Z","visibility":"public"},{"id":"an96babshon7064d","url":"https://misskey.io/notes/an96babshon7064d","text":"(seal..... しーる..... 覚えました)","user":{"name":"藍","username":"ai"},"files":0,"renotes":0,"replies":0,"reactions":0,"created_at":"2026-06-08T19:33:54.568Z","visibility":"public"}]},"meta":{"timestamp":"2026-06-09T03:03:34.377Z","request_id":"4e61d9c7-0547-402c-b000-5864d2fb4ca0"},"status":"ok","message":"User notes 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/user":{"get":{"operationId":"get_v1_user","tags":["Users"],"summary":"User profile","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Username","schema":{"type":"string"},"example":"ai"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"user":{"id":"7rkr3b1c1c","url":"https://misskey.io/@ai","name":"藍","notes":275451,"handle":"@ai","is_bot":true,"is_cat":true,"username":"ai","followers":21623,"following":1456,"avatar_url":"https://proxy.misskeyusercontent.jp/avatar.webp?url=https%3A%2F%2Fmedia.misskeyusercontent.jp%2Fmisskey%2Fwebpublic-ecc1008f-3e2e-4206-ae7e-5093221f08be.png&avatar=1","created_at":"2019-04-14T17:11:39.168Z","description":"Misskey常駐AIの藍です！\nよろしくお願いします♪\n\n[私のサイト](https://xn--931a.moe/) | [説明書](https://github.com/syuilo/ai/blob/master/torisetu.md)\n\nRepository: [Public](https://github.com/syuilo/ai)"}},"meta":{"timestamp":"2026-06-09T03:03:34.760Z","request_id":"dab919fd-d7a6-4b6e-a861-00292edb94bb"},"status":"ok","message":"User 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/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"Instance-wide stats","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":518168112,"users":1999644,"instances":35343,"reactions":601163619,"original_notes":165628882,"original_users":720211},"meta":{"timestamp":"2026-06-09T03:03:34.897Z","request_id":"8d7b7352-8aee-4d66-aaf6-b38da5f2d74c"},"status":"ok","message":"Stats 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":{"stats":{"notes":518168112,"users":720211},"source":"Misskey.io public API (live)","service":"misskey-api","instance":"misskey.io","endpoints":{"GET /v1/meta":"This document.","GET /v1/user":"User profile (username=, e.g. ai).","GET /v1/stats":"Instance-wide stats (notes, users, instances, reactions).","GET /v1/trends":"Currently trending hashtags with poster counts.","GET /v1/featured":"Featured (most-reacted) notes (limit).","GET /v1/user-notes":"A user's recent notes (username=, limit)."},"description":"Live data from Misskey.io, the largest Misskey instance (a decentralised Fediverse microblog, distinct from Mastodon): trending hashtags, featured (most-reacted) notes, user profiles, a user's recent notes, and instance stats. Live, no key."},"meta":{"timestamp":"2026-06-09T03:03:35.008Z","request_id":"2e3c18b0-61d4-418c-bf33-4fe0c4fd77ec"},"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":600,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":16000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":72000,"rps_limit":30,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":4900,"monthly_call_quota":360000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/misskey-api"}