ニコニコ動画APIとは (ニコニコドウガエーピーアイとは) [単語記事]

ニコニコ動画API とは、ニコニコ動画で利用可能なAPI （Application Program ming Interfa ce）である。

概要

現時点でも様々な方法でニコニコ動画内の情報（動画情報やサムネイルなど）を取得している方がいると思いますが、これも思ったより負荷がかかるので心情的にはやめてほしいというのが正直なところです。できれば負荷の少なそうな時間帯にやってもらえるとありがたいです、こっそりと。

最終的には他のサービスと同様にニコニコ動画内の情報を提供するAPIというのは用意していく予定で、具体的なスケジュールはまだ未定ですが年内にはいろいろできてるんじゃないかと思います。というわけで温かい目で見守ってください。情報は継続的に開発者ブログなんかで提供していきます。

とのことなのだが、どこからどう見ても継続的に開発者ブログで情報を提供している形跡はない。まあそれはともかく、APIが用意されている情報に関してはAPIを用いて取得しよう。そちらの方が一般的に楽。ニコニコチャートなどもこれらのAPIを使用してランキング情報を取得している。また、利用する際はheaderに個別のUser-Age ntを設定することが推奨されている。

公式API

スナップショット検索API

ニコニコ動画の動画を検索するための公式公開API「スナップショット検索 API」が2014年 10月15日に公開された。2016年 12月7日に、2017年 2月末頃を目途として「スナップショット検索API v2 」へと置き換えられることが発表された。JSONをPOSTすることで、特定のキーワードやフィルタ条件に合致する動画の情報を一括で取得できる。

ランキングの種類	説明	制約
daily	24hランキング(0時と5時生成)	2019年06月12日以降、任意の日付を指定可能
weekly	週間ランキング	2019年06月17日以降、毎週月曜日のみ指定可能
monthly	月間ランキング	2019年 07月01日以降、毎月1日のみ指定可能
total	全期間ランキング	2019年06月12日以降、任意の日付を指定可能

非公開API

存在自体は運営から公開されているわけではないが、存在が確認されているAPI。利用は自己責任で

getthumbinfo

GET https://ext.nico video.jp/api/gett humbinfo/{動画ID}

動画ID

smやsoから始まる動画を識別する固有のID

sm500873

動画の簡単な情報をXML形式で取得する。ログイン無しでも使用でき、アクセス制限が無いのが最大の特徴。動画IDまたはスレッド ID（コミュニティ動画やチャンネル動画で使われる数字のみから成るID）を指定できる。また、得られるものはほぼ最新の値だが、サーバー側でキャッシュが利いているらしく、何回かリロードすると値が変化することもある。

削除済み動画、コミュニティ動画、非表示設定されている動画は情報が得られず、 nico video_thumb_response タグのstatus 属性が "fail" となる（通常は"ok"）

項目名	説明	例(sm500873)
video_id	動画ID	sm500873
title	動画タイトル	組曲『ニコニコ動画』
description	動画説明文	700万再生、ありがとうございました...(以下省略)
thum bnail_url	動画サムネイルのURL	https://nico video.cdn.nimg.jp/thum bnails/500873/500873
first_retr ieve	投稿日時	2007-06-23T18:27:06+09:00
len gth	動画の再生時間	10:48
movie_type	動画の形式(flv,mp4,swf)	flv
size_high	動画サイズ(byte)	40007472
size_low	低画質時の動画サイズ(byte)	35192581
view_counter	再生数	1183 1754
comment_num	コメント数	4920095
mylist_counter	マイリスト数	155571
last_res_body	直近のコメント	目指せ500万コメントなう(2022/10/20 07:56:40) ( ﾟ∀ﾟ)o彡゜えーりん！とかちつくちてきしめえええええええ
watch_url	視聴URL	https://www .nico video.jp/watch/sm500873
thumb_type	固定video	video
embedda ble	外部プレイヤーで再生可能か(0=不可能,1=可能)	1
no_live _play	ニコ生で再生禁止か(0=可能,1=禁止)	0
tags	設定されているタグのリスト	domain 属性で国が指定(jpのみ)
└tag	タグ	category 属性でカテゴリタグか、lock 属性でロックされているか
genre	ジャンル名	音楽・サウンド
user_id	投稿者のユーザー ID	145 217
user_nickname	投稿者の名前	しも
user_icon_url	投稿者のアイコンのURL	https://sec ure-dcdn.cdn.nimg.jp/nico account/user icon/defaults/blank_s.jpg
ch_id	チャンネル ID	-
ch_name	チャンネル名	-
ch_icon_url	チェンネルのアイコンのURL	-