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

ニコニコ動画API とは、ニコニコ動画で利用可能なAPI(Application Programming 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することで、特定のキーワードやフィルタ条件に合致する動画の情報を一括で取得できる。

ニコニコ非公開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_retrieve	投稿日時	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	-

nvapi

ジャンル別のランキングデータが取得できる。

前提

以下のリクエストヘッダーが必須になっている模様。なお、クエリパラメータに「_front end Id=6」を指定しないとランキングデータからなぜか一部動画が欠落することがある。

ヘッダー名	説明
User-Age nt	作成しているツール名を入力する。具体的なツール名をきちんと明記しないとはじかれる危険がある。
Cookie	ニコニコ動画のuser_session Cookieを指定する。

一覧取得

GET https://nvapi.nico video.jp/v2/genres

ジャンル一覧が取得できる。

レスポンスは以下のようにジャンルキーとラベルの組み合わせになっている。

"key": "music",
"label": "音楽"

このジャンルキーを後述のランキングデータで指定する。

パラメータ名	必須要否	説明
{ジャンルキー}	必須	allを指定すると全ジャンルが取得可能。個別のジャンルを取得する場合は一覧取得で確認したジャンルキーを使用する。

パラメータ名	必須要否	デフォルト値	説明
term	必須	24h	ランキングの集計期間でそれぞれのランキングについては以下の値になっている。 24時間ランキング→24h 毎時ランキング→hour 週間ランキング→week 月間ランキング→month 全期間ランキング→total
page	任意	1	ページの番号
pageSize	任意	25	1ページあたりの取得件数だが、任意の数は指定できない。25と100しか用意されていない模様。

キー	値	備考
id	動画ID
title	動画タイトル
thum bnail		わざわざ別項目が立てられているがサムネイル画像のURLしか出力されない。
└lis tingUrl	サムネイル画像URL
regi stered At	投稿日時	ISO 8601形式
count		数値領域だが順位の数値データは入っていない
└view	再生数
└comment	コメント数
└mylist	マイリスト数
└like	いいね数