{"openapi":"3.1.0","info":{"title":"Niconico Video API","version":"1.0.0","description":"Live video, search and engagement data from Niconico (nicovideo.jp), the pioneering Japanese video platform that invented danmaku — the comments that scroll across the video itself — read keyless from Niconico's public Snapshot Search API and video-info endpoint. Niconico is one of Japan's biggest video communities, the home of Vocaloid, \"Let's Play\" culture and a vast catalogue with videos counting tens of millions of views and millions of overlaid comments. This exposes what is popular, who is watching and how each video is performing across Niconico's distinctive engagement signals — views, the famous scrolling comments, mylist bookmarks and likes. The search endpoint finds videos by keyword, sorted by views, comments, mylists, likes or upload date — the way to surface the platform's most-watched and most-discussed content. The tag endpoint browses an exact Niconico tag (the platform's main discovery axis — VOCALOID, ゲーム/games, 音楽/music, アニメ/anime) ranked by views, so you can see what leads a category. The video endpoint returns one video's full detail by its watch id (the sm/nm/so id), including its description, tags, length, upload date and uploader. This is the Niconico platform cut — a distinct social/video platform, separate from the YouTube, Bilibili, TikTok, BitChute and other platform feeds in the catalogue. View, comment, mylist and like counts are live; nothing is stored beyond a short cache. Counts are integers; dates are as the platform reports them (JST).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/niconico-api","description":"oanor gateway"}],"tags":[{"name":"Search"},{"name":"Tag"},{"name":"Video"},{"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 videos by keyword, sorted by engagement","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search keyword","schema":{"type":"string"},"example":"VOCALOID"},{"name":"sort","in":"query","required":false,"description":"views, comments, mylists, likes or new","schema":{"type":"string"},"example":"views"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Niconico videos matching a keyword, sorted by views (views, comments, mylists, likes or new) — each with its view count, scrolling-comment count, mylist (bookmark) count and likes. Pass q (required), sort (default views), in=description to search descriptions instead of titles, and limit (1-50). Live, cached ~60s.","sort":"views","count":20,"query":"VOCALOID","source":"Niconico Snapshot Search API (snapshot.search.nicovideo.jp), keyless","videos":[{"likes":13155,"title":"【VOCALOID 原創】ECHO【Gumi English】","views":9092876,"mylists":95270,"user_id":19241380,"comments":94176,"uploaded":"2014-10-08T13:39:07+09:00","video_url":"https://www.nicovideo.jp/watch/sm24643818","content_id":"sm24643818","length_seconds":244},{"likes":13413,"title":"VOCALOID2 初音ミクに「Ievan Polkka」を歌わせてみた","views":6695250,"mylists":126893,"user_id":85430,"comments":227356,"uploaded":"2007-09-04T12:55:53+09:00","video_url":"https://www.nicovideo.jp/watch/sm982882","content_id":"sm982882","length_seconds":146},{"likes":1390,"title":"VOCALOIDでニコニコ動画流星群【完成版】","views":2137595,"mylists":63844,"user_id":1353089,"comments":309999,"uploaded":"2008-08-31T00:08:12+09:00","video_url":"https://www.nicovideo.jp/watch/sm4468648","content_id":"sm4468648","length_seconds":836},{"likes":1831,"title":"【VOCALOIDミュージカル】Alice in Musicland【オリジナル曲】 ","views":2131340,"mylists":102538,"user_id":308936,"comments":163397,"uploaded":"2011-07-24T20:20:51+09:00","video_url":"https://www.nicovideo.jp/watch/sm15108950","content_id":"sm15108950","length_seconds":718},{"likes":368,"title":"島風＆金剛にハッピーシンセサイザ歌わせてみた【人力VOCALOID＆艦これ】","views":1617162,"mylists":38638,"user_id":21073301,"comments":9715,"uploaded":"2013-12-06T21:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm22400980","content_id":"sm22400980","length_seconds":235},{"likes":629,"title":"VOCALOID3 鳥の詩(Ver.IA) full 製品版デモ","views":1352014,"mylists":27064,"user_id":7734512,"comments":22247,"uploaded":"2012-01-17T19:27:48+09:00","video_url":"https://www.nicovideo.jp/watch/sm16719480","content_id":"sm16719480","length_seconds":371},{"likes":653,"title":"【VOCALOID Fukase】僕がモンスターになった日【オリジナル】","views":1186252,"mylists":15560,"user_id":2591026,"comments":9974,"uploaded":"2016-01-08T11:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm27962865","content_id":"sm27962865","length_seconds":200},{"likes":650,"title":"【人力VOCALOID】Level5 -judgelight-【とある科学の超電磁砲】","views":1174947,"mylists":21341,"user_id":614655,"comments":8149,"uploaded":"2010-10-12T01:46:10+09:00","video_url":"https://www.nicovideo.jp/watch/sm12403999","content_id":"sm12403999","length_seconds":125},{"likes":828,"title":"【人力VOCALOID】白金ディスコ【高槻やよい】","views":1089685,"mylists":22557,"user_id":614655,"comments":6159,"uploaded":"2012-11-11T21:11:32+09:00","video_url":"https://www.nicovideo.jp/watch/sm19333505","content_id":"sm19333505","length_seconds":89},{"likes":858,"title":"【VOCALOID×8】茶番カプリシオ【オリジナル】","views":1073581,"mylists":15142,"user_id":907343,"comments":34539,"uploaded":"2011-10-29T15:07:59+09:00","video_url":"https://www.nicovideo.jp/watch/sm16017826","content_id":"sm16017826","length_seconds":299},{"likes":869,"title":"【人力VOCALOID】サウダージ (feat.天海春香)","views":980971,"mylists":14520,"user_id":2917992,"comments":4328,"uploaded":"2011-09-25T01:58:27+09:00","video_url":"https://www.nicovideo.jp/watch/sm15704392","content_id":"sm15704392","length_seconds":247},{"likes":240,"title":"【人力VOCALOID×宇多田ヒカル】「ココロ」","views":956883,"mylists":17188,"user_id":2917992,"comments":18216,"uploaded":"2011-01-24T00:00:10+09:00","video_url":"https://www.nicovideo.jp/watch/sm13390409","content_id":"sm13390409","length_seconds":282},{"likes":1843,"title":"【ニコニコラボ】Connecting【Vocaloid】","views":943693,"mylists":15059,"user_id":1101042,"comments":10029,"uploaded":"2014-12-05T20:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm25056423","content_id":"sm25056423","length_seconds":300},{"likes":302,"title":"【人力VOCALOID】Utauyo!!MIRACLE【高槻やよい】","views":926863,"mylists":24107,"user_id":614655,"comments":9738,"uploaded":"2012-03-25T00:03:16+09:00","video_url":"https://www.nicovideo.jp/watch/sm17348916","content_id":"sm17348916","length_seconds":187},{"likes":861,"title":"VOCALOID2 鏡音リン・レンに「Ievan Polkka」を歌わせてみた(仮ver.)","views":866683,"mylists":16855,"user_id":85430,"comments":27657,"uploaded":"2007-12-29T14:45:48+09:00","video_url":"https://www.nicovideo.jp/watch/sm1893548","content_id":"sm1893548","length_seconds":146},{"likes":395,"title":"【作業用BGM】VOCALOIDオルゴールメドレー【睡眠用BGM】","views":832924,"mylists":17388,"user_id":3196580,"comments":5951,"uploaded":"2010-11-30T22:22:26+09:00","video_url":"https://www.nicovideo.jp/watch/sm12902949","content_id":"sm12902949","length_seconds":6134},{"likes":85,"title":"【ドット絵】VOCALOID どこかで見たようなゲーム風動画・完全版","views":832499,"mylists":25045,"user_id":215565,"comments":125879,"uploaded":"2008-01-09T23:26:29+09:00","video_url":"https://www.nicovideo.jp/watch/sm1991872","content_id":"sm1991872","length_seconds":1077},{"likes":537,"title":"【人力VOCALOID】Let's go！スマイルプリキュア！【菊地真】","views":807663,"mylists":15090,"user_id":614655,"comments":3285,"uploaded":"2012-10-28T00:00:47+09:00","video_url":"https://www.nicovideo.jp/watch/sm19218832","content_id":"sm19218832","length_seconds":85},{"likes":1338,"title":"うらめしヤッホー - 和田たけあき (VOCALOID ver.)","views":794344,"mylists":4813,"user_id":466979,"comments":3575,"uploaded":"2019-08-04T18:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm35489203","content_id":"sm35489203","length_seconds":185},{"likes":614,"title":"【巡音ルカ】Heart Beats【オリジナル】【ＶＯＣＡＬＯＩＤ】","views":746707,"mylists":20297,"user_id":3967970,"comments":5744,"uploaded":"2010-06-21T02:28:37+09:00","video_url":"https://www.nicovideo.jp/watch/sm11134936","content_id":"sm11134936","length_seconds":299}],"total_matches":45407},"meta":{"timestamp":"2026-06-13T04:42:51.444Z","request_id":"e5afef7b-be0b-46e5-bd9f-a162249a2d16"},"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/tag":{"get":{"operationId":"get_v1_tag","tags":["Tag"],"summary":"Top videos under an exact Niconico tag","description":"","parameters":[{"name":"tag","in":"query","required":true,"description":"An exact Niconico tag","schema":{"type":"string"},"example":"VOCALOID"},{"name":"sort","in":"query","required":false,"description":"views, comments, mylists, likes or new","schema":{"type":"string"},"example":"views"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tag":"VOCALOID","note":"The top Niconico videos under an exact tag, ranked by views — tags are Niconico's main discovery axis, so this is how a category (VOCALOID, ゲーム/games, 音楽/music, アニメ/anime…) is performing. total_videos is how many videos carry the tag. Pass tag (required), sort (default views) and limit (1-50). Live, cached ~60s.","sort":"views","count":20,"source":"Niconico Snapshot Search API (tagsExact), keyless","videos":[{"likes":42744,"title":"『初音ミク』千本桜『オリジナル曲PV』","views":18648461,"mylists":333341,"user_id":449061,"comments":1581065,"uploaded":"2011-09-17T19:00:28+09:00","video_url":"https://www.nicovideo.jp/watch/sm15630734","content_id":"sm15630734","length_seconds":244},{"likes":20956,"title":"【初音ミク】みくみくにしてあげる♪【してやんよ】","views":17275854,"mylists":231153,"user_id":70391,"comments":3008410,"uploaded":"2007-09-20T01:22:02+09:00","video_url":"https://www.nicovideo.jp/watch/sm1097445","content_id":"sm1097445","length_seconds":99},{"likes":37031,"title":"初音ミク　が　オリジナル曲を歌ってくれたよ「メルト」","views":17073063,"mylists":310796,"user_id":317063,"comments":1059276,"uploaded":"2007-12-07T20:46:02+09:00","video_url":"https://www.nicovideo.jp/watch/sm1715919","content_id":"sm1715919","length_seconds":256},{"likes":31737,"title":"初音ミク・巡音ルカ　オリジナル曲　「ワールズエンド・ダンスホール」","views":16079119,"mylists":210755,"user_id":11912389,"comments":656255,"uploaded":"2010-05-18T10:46:14+09:00","video_url":"https://www.nicovideo.jp/watch/sm10759623","content_id":"sm10759623","length_seconds":217},{"likes":22093,"title":"【オリジナル曲PV】マトリョシカ【初音ミク・GUMI】","views":15424984,"mylists":235412,"user_id":380847,"comments":371334,"uploaded":"2010-08-19T22:25:45+09:00","video_url":"https://www.nicovideo.jp/watch/sm11809611","content_id":"sm11809611","length_seconds":200},{"likes":57197,"title":"wowaka『アンノウン・マザーグース』feat. 初音ミク","views":14522612,"mylists":86881,"user_id":11912389,"comments":275520,"uploaded":"2017-08-22T17:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm31791630","content_id":"sm31791630","length_seconds":285},{"likes":56878,"title":"初音ミク　オリジナル曲　「ローリンガール」","views":13644245,"mylists":168168,"user_id":11912389,"comments":211373,"uploaded":"2010-02-14T20:00:02+09:00","video_url":"https://www.nicovideo.jp/watch/sm9714351","content_id":"sm9714351","length_seconds":196},{"likes":14228,"title":"DECO*27 - モザイクロール feat. GUMI","views":13245642,"mylists":225691,"user_id":811012,"comments":534037,"uploaded":"2010-07-15T20:17:34+09:00","video_url":"https://www.nicovideo.jp/watch/sm11398357","content_id":"sm11398357","length_seconds":191},{"likes":30158,"title":"【IA】アスノヨゾラ哨戒班【オリジナル】","views":13038316,"mylists":109954,"user_id":32260190,"comments":183116,"uploaded":"2014-08-19T20:37:55+09:00","video_url":"https://www.nicovideo.jp/watch/sm24276234","content_id":"sm24276234","length_seconds":176},{"likes":22917,"title":"DECO*27 - ゴーストルール feat. 初音ミク","views":12768399,"mylists":117231,"user_id":811012,"comments":191219,"uploaded":"2016-01-08T20:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm27965309","content_id":"sm27965309","length_seconds":206},{"likes":28936,"title":"ハチ MV「砂の惑星 feat.初音ミク」","views":12338330,"mylists":117886,"user_id":380847,"comments":257260,"uploaded":"2017-07-21T17:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm31606995","content_id":"sm31606995","length_seconds":239},{"likes":21208,"title":"【IA】六兆年と一夜物語【オリジナル曲・PV付】","views":12072396,"mylists":197343,"user_id":24550889,"comments":320120,"uploaded":"2012-04-11T19:55:10+09:00","video_url":"https://www.nicovideo.jp/watch/sm17520775","content_id":"sm17520775","length_seconds":220},{"likes":31725,"title":"天ノ弱／164 feat.GUMI","views":11728574,"mylists":184128,"user_id":582229,"comments":206755,"uploaded":"2011-05-28T21:00:49+09:00","video_url":"https://www.nicovideo.jp/watch/sm14583646","content_id":"sm14583646","length_seconds":191},{"likes":20768,"title":"GUMI MV「ドーナツホール」","views":11714712,"mylists":124840,"user_id":380847,"comments":140584,"uploaded":"2013-10-28T19:22:41+09:00","video_url":"https://www.nicovideo.jp/watch/sm22138447","content_id":"sm22138447","length_seconds":210},{"likes":35102,"title":"【初音ミク】 ウミユリ海底譚 【オリジナル曲】","views":11711281,"mylists":115361,"user_id":26225387,"comments":141032,"uploaded":"2014-02-24T19:05:46+09:00","video_url":"https://www.nicovideo.jp/watch/sm22960446","content_id":"sm22960446","length_seconds":238},{"likes":21280,"title":"初音ミクオリジナル曲　「初音ミクの消失（LONG VERSION）」","views":11643259,"mylists":184009,"user_id":1091989,"comments":392945,"uploaded":"2008-04-08T20:56:48+09:00","video_url":"https://www.nicovideo.jp/watch/sm2937784","content_id":"sm2937784","length_seconds":287},{"likes":40017,"title":"DECO*27 - ヒバナ feat. 初音ミク","views":11417738,"mylists":94222,"user_id":811012,"comments":58489,"uploaded":"2017-08-04T19:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm31685272","content_id":"sm31685272","length_seconds":202},{"likes":21052,"title":"【初音ミク＆GUMI】脳漿炸裂ガール【オリジナル】","views":11279452,"mylists":169852,"user_id":2591026,"comments":209732,"uploaded":"2012-10-19T20:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm19133907","content_id":"sm19133907","length_seconds":191},{"likes":21404,"title":"「ロミオとシンデレラ」　オリジナル曲　vo.初音ミク","views":11167252,"mylists":187467,"user_id":655340,"comments":168046,"uploaded":"2009-04-06T05:56:10+09:00","video_url":"https://www.nicovideo.jp/watch/sm6666016","content_id":"sm6666016","length_seconds":280},{"likes":88937,"title":"きゅうくらりん / いよわ feat.可不","views":11166983,"mylists":44655,"user_id":78166728,"comments":21728,"uploaded":"2021-08-29T20:00:00+09:00","video_url":"https://www.nicovideo.jp/watch/sm39257413","content_id":"sm39257413","length_seconds":216}],"total_videos":906100},"meta":{"timestamp":"2026-06-13T04:42:52.230Z","request_id":"81db8093-d8cf-4847-89ac-987281994265"},"status":"ok","message":"Tag 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/video":{"get":{"operationId":"get_v1_video","tags":["Video"],"summary":"One video's full detail by watch id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"A Niconico watch id","schema":{"type":"string"},"example":"sm9"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"One Niconico video's full detail: its view count, scrolling-comment count and mylist (bookmark) count, its length, upload date, genre, uploader and tags. Live, cached ~60s.","tags":["陰陽師","レッツゴー！陰陽師","公式","音楽","ゲーム","弾幕動画","矢部野彦麿","3月6日投稿動画","重要ニコニコ文化財","お前らの愛で見えなくしたい","ニコニ国歌"],"genre":"未設定","title":"新・豪血寺一族 -煩悩解放 - レッツゴー！陰陽師","views":22965866,"length":"5:20","source":"Niconico getthumbinfo API (ext.nicovideo.jp), keyless","mylists":183056,"comments":5670147,"uploaded":"2007-03-06T00:33:00+09:00","uploader":"中の","video_url":"https://www.nicovideo.jp/watch/sm9","content_id":"sm9","description":"レッツゴー！陰陽師（フルコーラスバージョン）","thumbnail_url":"https://nicovideo.cdn.nimg.jp/thumbnails/9/9"},"meta":{"timestamp":"2026-06-13T04:42:53.079Z","request_id":"54e5d028-75fb-4ffb-96ef-07afe9b6eff9"},"status":"ok","message":"Video 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":{"note":"search takes q (required), sort (views/comments/mylists/likes/new, default views), in=description (optional) and limit (1-50). tag takes tag (an exact Niconico tag, required), sort and limit. video takes id (a watch id like sm9, required). meta takes no parameters. Counts are live integers from the upstream; a short ~60-second cache fronts it.","source":"Niconico Snapshot Search API + getthumbinfo, keyless, live","service":"niconico-api","endpoints":{"GET /v1/tag":"Top videos under an exact tag (tag=音楽).","GET /v1/meta":"This document.","GET /v1/video":"One video's full detail by watch id (id=sm9).","GET /v1/search":"Search videos by keyword, sorted by engagement (q=VOCALOID, sort=views)."},"description":"Live video, search and engagement data from Niconico (nicovideo.jp), the pioneering Japanese video platform that invented danmaku (comments scrolling across the video), from its public Snapshot Search API and getthumbinfo endpoint (no key). The search endpoint finds videos by keyword sorted by views/comments/mylists/likes/new; tag browses an exact Niconico tag ranked by views (the platform's main discovery axis); video returns one video's full detail by its watch id. The Niconico platform cut — a distinct social/video platform, separate from the YouTube, Bilibili, TikTok, BitChute and other platform feeds. Engagement: views, scrolling comments, mylist bookmarks and likes.","sample_video":{"title":"新・豪血寺一族 -煩悩解放 - レッツゴー！陰陽師","views":22965459},"upstream_status":"ok"},"meta":{"timestamp":"2026-06-13T04:42:53.399Z","request_id":"81a5a105-a1de-487e-8b48-b283e93a4f8a"},"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":1300,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1450,"monthly_call_quota":32000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5300,"monthly_call_quota":175000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":14700,"monthly_call_quota":620000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/niconico-api"}