ニコニコ動画API単語

• 概要
• 公式API
• 非公式API
• API利用ツール等
• 外部リンク
• 関連項目
• 脚注
• 掲示板

ニコニコ動画API とは、ニコニコ動画で利用可能なAPI （Application Programming Interface）である。

概要

中の人曰く、 ^[1]

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

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

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

公式API

スナップショット検索API

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

ランキング過去ログファイルAPI

新ランキング移行に伴い、過去のランキングデータの提供方法がブラウザ上での閲覧機能から「ランキング過去ログファイルAPI」へと置き換わりました。取得できる情報は以下のとおりです。

全ジャンル/各ジャンル/各ジャンルのピックアップカテゴリーそれぞれごとの以下の情報が取得できます。
詳しくは説明ページを確認してください。ただし上位100位までのみです。

ランキングの種類	説明	制約
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.nicovideo.jp/api/getthumbinfo/{動画ID}

動画ID

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

sm500873

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

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

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

thumb

GET https://ext.nicovideo.jp/thumb/{動画ID}

張り付け用のiframeが得られる。↓こんなの

getrelation

GET https://flapi.nicovideo.jp/api/getrelation?page=1&sort=commentCount&order=acs&video=sm9

動画に関連するオススメ動画リストをXML形式で取得できる。

nvcomment

GET https://nvcomment.nicovideo.jp/legacy/api.json/thread?nicoru=3&res_from=-1000&scores=1&thread=1173108780&version=20090904&with_global=1

指定した動画のコメントをJSON形式で取得できる

rss

GET https://www.nicovideo.jp/**/**?rss=atom
GET https://www.nicovideo.jp/**/**?rss=2.0

マイリストや投稿動画一覧などのURLの最後に「?rss=atom（または2.0）」と打ち込んでアクセスするとATOM（RSS）形式で表示され、購読することも可能

非公式API

ニコニコ実況過去ログAPI

ニコニコ実況過去ログAPIとはニコニコ実況のコメント過去ログをXML形式、JSON形式で取得できる非公式API。それぞれの実況チャンネルのコメントを日時範囲指定で取得できる。

API利用ツール等

ここではニコニコ動画APIを利用するライブラリ及びツールの例を紹介する。

nicovideo gem （Ruby）

インストール方法
% gem install nicovideo

nicovideo Thumbinfo popup （Greasemonkeyスクリプト）

nicovideo Thumbinfo popup は、ニコニコ動画へのリンクにマウスカーソルを載せるとサムネイル情報をポップアップ表示する。

NicoApiWrapper

ニコニコ技術部員の作成したツール、兼ライブラリ。Javaで書かれており利用方法も動画で紹介されている。

外部リンク

• ニコニコ動画 API - Google 検索
• スナップショット検索API v2
• 【技術者向け】ニコニコ動画検索のAPI公開について

関連項目

• API
• ニコ生アラート（本家）の仕様
• NicoApiWrapper

脚注

1. *外部プレーヤーや各種APIの開放について より引用