単語記事: ニコニコ動画API

編集

ニコニコ動画API とは、ニコニコ動画で利用可API (Application Programming Interface)である。

概要

中の人く、 [1]

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

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

とのことなのだが、どこからどう見ても継続的に開発者ブログ情報提供している形跡はない。まあそれはともかく、APIが用意されている情報に関してはAPIを用いて取得しよう。そちらの方が一般的に楽。ニコニコチャート(http://www.nicochart.jp/)などもこれらのAPIを使用してランキング情報を取得している。

スナップショット検索API

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

その他公式で利用されているAPIの一覧

現在以下のAPIの存在が確認されている。

getthumbinfo
http://ext.nicovideo.jp/api/getthumbinfo/sm*
動画情報を得られる
thumb
http://ext.nicovideo.jp/thumb/sm*
り付け用のiframeが得られる
getflv
http://flapi.nicovideo.jp/api/getflv/sm*
定された動画FLV保管URLを取得できる
getmarquee
http://flapi.nicovideo.jp/api/getmarquee?*
時報データの取得、ニコ割ゲームの取得、ニワニュース情報局のニュースインデックスの取得ができる
getrelation
http://flapi.nicovideo.jp/api/getrelation?page=**&sort=**&order=**&video=**
それぞれpage,sort,order,videoを設定してアクセスすると、動画に関連するオススメ動画リストXML形式で取得できる
msg
http://msg.nicovideo.jp/**/api
このURLに、XMLPOSTすると、定した動画コメントを取得できる
rss
http://www.nicovideo.jp/**/**?rss=atom or http://www.nicovideo.jp/**/**?rss=2.0
マイリスト投稿動画一覧などのURLの最後に「?rss=atom(または2.0)」と打ち込んでアクセスすると、ATOM(RSS)形式で表示され、購読することも可

getthumbinfo

ログインしでも使用でき、アクセス制限がいのが最大の特徴。動画IDまたはスレッドIDマイメモリーコミュニティ動画チャンネル動画で使われる数字のみから成るID)を定できる。

URLhttp://ext.nicovideo.jp/api/getthumbinfo/sm**

以下は取得出来る値の一覧括弧内は「組曲『ニコニコ動画』」(http://www.nicovideo.jp/watch/sm500873)について取得した場合の値
チャンネル動画の値は通常の動画(sm)などには存在しない。

video_id
動画ID (sm500873)
title
動画タイトル 当然省略し。(組曲『ニコニコ動画』)
description
動画説明文 HTMLタグ削除される。 2013/12/10からHTMLも表示されるようになった。
thumbnail_url
サムネイル画像のURL (http://tn-skr2.smilevideo.jp/smile?i=500873)
first_retrieve
投稿日時 (2007-06-23T18:27:06+09:00)
length
動画の再生時間 (10:47)
movie_type
動画の形式
Flash Video形式なら"flv"、MPEG-4形式なら"mp4"。(flv)、ニコニコムービーメーカーは、"swf"
size_high
動画サイズバイト単位。(40007472)
size_low
低画質モード時の動画サイズ。(35192581)
view_counter
再生数
comment_num
コメント
mylist_counter
マイリスト
last_res_body
ブログパーツなどに表示される最新コメント
watch_url
視聴URL (http://ext.nicovideo.jp/watch/sm500873)
thumb_type
動画なら「video」、マイメモリーなら「mymemory」(video)
embeddable
外部プレイヤーで再生可 (1) か、再生不可 (0) を示す (1)
no_live_play
ニコニコ生放送で再生禁止 (1) か、再生可 (0) を示す (0)
tags
タグ全て。domain属性が"jp"なら日本語タグ、ただし現状日本タグのみ。"tw", "de", "es" はされた(→海外タグ)。
個々のタグは、tagタグで列挙。カテゴリタグcategory属性が "1" となり、タグロックされていると lock属性が "1" となる。
user_id
うp主ユーザID (145217)
user_nickname
うp主ユーザー名 (しも)
user_icon_url
うp主ユーザーアイコン (http://usericon.nimg.jp/usericon/s/14/145217.jpg?1386998639)
ch_id
チャンネルID
ch_name
チャンネル
ch_icon_url
チャンネルアイコン

ほぼ最新の値だが、サーバー側でキャッシュが利いているらしく、何回かリロードすると値が変化することもある。

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

実際に取得できるxmlについては、 http://ext.nicovideo.jp/api/getthumbinfo/sm500873 を参照のこと。

API利用ツール等

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

nicovideo gem (Ruby)

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

nicovideo Thumbinfo popup (Greasemonkeyスクリプト)

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

NicoApiWrapper

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

外部リンク

関連項目

脚注

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

【スポンサーリンク】

携帯版URL:
http://dic.nicomoba.jp/k/a/%E3%83%8B%E3%82%B3%E3%83%8B%E3%82%B3%E5%8B%95%E7%94%BBapi
ページ番号: 430 リビジョン番号: 2465855
読み:ニコニコドウガエーピーアイ
初版作成日: 08/05/13 22:25 ◆ 最終更新日: 17/03/05 23:51
編集内容についての説明/コメント: 「スナップショット検索 v2」に言及
記事編集 / 編集履歴を閲覧

この記事の掲示板に最近描かれたお絵カキコ

お絵カキコがありません

この記事の掲示板に最近投稿されたピコカキコ

ピコカキコがありません

ニコニコ動画APIについて語るスレ

71 : ななしのよっしん :2015/10/15(木) 08:33:45 ID: YI75aiZByp
ごめん自己解決
http://www.slideshare.net/masahiroh1/ss-24757915
72 : ななしのよっしん :2015/10/24(土) 12:56:06 ID: JYqVrVR28Y
ユーザー投稿している動画数を知るAPIとかRSSはないかな?
73 : ななしのよっしん :2015/12/04(金) 16:30:12 ID: kxC3cdOWYV
>>72
http://www.nicovideo.jp/user/{ユーザーID}/video
から取ってくるしかないかと
74 : ななしのよっしん :2016/05/22(日) 11:57:18 ID: a51Xsq2xZr
お気に入りの一覧を取得するAPIってありますか?
www.nicovideo.jp/api/watchitem/listだとお気に入り登録されたユーザーしか取れなくて困ってます
お気に入りの追加や削除等は/watchitem/add他でできるのはfirebugで確認できました
/my/fav/mylist等のページをパースして取るしかないでしょうか?
75 : ななしのよっしん :2016/05/22(日) 17:01:39 ID: a51Xsq2xZr
一部自己解決
お気に入りタグだけ別途APIが準備されているようです ( /api/favtag/[list,add,delete] )

他はリスト取得はマイページ上の該当ページ(/my/fav/mylist など)のHTMLを取得して解析、追加や削除は /api/watchitem/* を利用すればいけそうです。

参考:http://res.nimg.jp/scripts/dao/FavtagDao.js?1377581665
76 : ななしのよっしん :2017/02/04(土) 00:50:03 ID: 3nNT5DfI8m
生放送の再生開始時間を取れるAPIって今はいのか?
昔の記事見るとhttp://live.nicovideo.jp/api/getstreaminfo/lv*** で取れるって書いてあったが、今試したらダメだった

http://live.nicovideo.jp/embed/lv* のレスポンスをパースすれば取れるが、他に手段はないのか・・・・?
77 : ななしのよっしん :2017/02/05(日) 13:32:39 ID: H7MkI+ILSd
>>76
公式 API v1
http://api.ce.nicovideo.jp/liveapi/v1/video.info?v=lv**
xml <open_time>
ソースはここ http://nico-lab.net/access_restriction_nico_api_v1/
末(2017年2月末)からAPIv2に切り替わるらしいけど。APIv2
http://site.nicovideo.jp/search-api-docs/snapshot.html
78 : ななしのよっしん :2017/02/05(日) 16:11:52 ID: H7MkI+ILSd
>>76
ごめんなさい。検索APIv2はこっちだった(>>77v2はスナップショットAPI
http://search.nicovideo.jp/docs/api/search.html
http://api.search.nicovideo.jp/api/v2/:service/contents/search
79 : anatawa12 :2017/02/20(月) 21:59:52 ID: 2QU6aVv+HX
getthumbinfoはsmがない動画じゃないと取得ができない。
何か代わりのAPIないかな
80 : ななしのよっしん :2017/03/19(日) 13:56:29 ID: H7MkI+ILSd
スナップショット検索APIv2メインになって
コンテンツ検索APIv2検索βとが削除されたみたいです。
>>78URLつながりません。>>77を使えということらしい。
参考ブロマガ http://ch.nicovideo.jp/nico-lab/blomaga/ar930955
  JASRAC許諾番号: 9011622001Y31015