ニコニコ動画APIとは、ニコニコ動画で利用可能なAPI (Application Programming Interface)である。
概要
現時点でも様々な方法でニコニコ動画内の情報(動画情報やサムネイルなど)を取得している方がいると思いますが、これも思ったより負荷がかかるので心情的にはやめてほしいというのが正直なところです。できれば負荷の少なそうな時間帯にやってもらえるとありがたいです、こっそりと。
最終的には他のサービスと同様にニコニコ動画内の情報を提供するAPIというのは用意していく予定で、具体的なスケジュールはまだ未定ですが年内にはいろいろできてるんじゃないかと思います。というわけで温かい目で見守ってください。情報は継続的に開発者ブログなんかで提供していきます。
とのことなのだが、どこからどう見ても継続的に開発者ブログで情報を提供している形跡はない。
まあそれはともかく、APIが用意されている情報に関してはAPIを用いて取得しましょう。そちらの方が一般的に楽です。
ニコニコチャート(http://www.nicochart.jp/
)などもこれらのAPIを使用してランキング情報を取得している。ニコニコチャートはAPIをわけありで使ってないらしい。
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に、XMLをPOSTすると、指定した動画のコメントを取得できる
- 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）を指定できる。
URLはhttp://ext.nicovideo.jp/api/getthumbinfo/sm**
以下は取得出来る値の一覧。括弧内は「組曲『ニコニコ動画』」（http://www.nicovideo.jp/watch/sm500873
）について取得した場合の値
- video_id
- 動画ID。(sm500873)
- title
- 動画タイトル。当然省略は無し。(組曲『ニコニコ動画』)
- description
- 動画説明文。当然全文で、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)
- 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
- うｐ主のユーザID。(145217 = しも)
ほぼ最新の値だが、サーバー側でキャッシュが利いているらしく、何回かリロードすると数が減ることもある。
動画が削除または非表示設定されている場合は情報が得られず、nicovideo_thumb_responseタグのstatus属性が"fail"となる（通常は"ok"）。
実際に取得できるxmlについては、http://ext.nicovideo.jp/api/getthumbinfo/sm500873を参照のこと。
API利用ツール等
nicovideo gem (Ruby)
インストール方法
% gem install nicovideo
nicovideo Thumbinfo popup (Greasemonkeyスクリプト)
nicovideo Thumbinfo popupは、ニコニコ動画へのリンクにマウスカーソルを載せるとサムネイル情報をポップアップ表示する。
NicoApiWrapper
ニコニコ技術部員の作成したツール、兼ライブラリ。javaで書かれており利用方法も動画で紹介されている。
外部リンク
関連項目
脚注
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
リビジョン番号: 1538118
読み：ニコニコドウガエーピーアイ
初版作成日: 08/05/13 22:25 ◆ 最終更新日: 12/05/25 19:19
編集内容についての説明/コメント: getthumbinfoに関して修正(BBS#42)、追記。関連項目追加。概要編集。整形。
記事編集 / 編集履歴を閲覧 / Twitterで紹介
JASRAC許諾番号: 9011622001Y31015
ヘッダー：固定
ヘッダー：追従