編集  

ニコニコ動画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」では、https://api.search.nicovideo.jp/api/v2/snapshot/video/contents/searchに対してJSONPOSTすることで、特定キーワードフィルタ条件に合致する動画情報を一括で取得できる。

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

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

getthumbinfo
https://ext.nicovideo.jp/api/getthumbinfo/sm*
動画情報を得られる
thumb
https://ext.nicovideo.jp/thumb/sm*
り付け用のiframeが得られる
getflv
https://flapi.nicovideo.jp/api/getflv/sm*
定された動画FLV保管URLを取得できる
getmarquee
http://flapi.nicovideo.jp/api/getmarquee?*
時報データの取得、ニコ割ゲームの取得、ニワニュース情報局のニュースインデックスの取得ができる
(2018年8月26現在 接続不可能)
getrelation
https://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)を定できる。

URLhttps://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 (https://tn.smilevideo.jp/smile?i=500873)
first_retrieve
投稿日時 (2007-06-23T18:27:06+09:00)
length
動画の再生時間 (10:48)
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://www.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主ユーザーアイコン (https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/s/14/145217.jpg?1386998639)
ch_id
チャンネルID
ch_name
チャンネル
ch_icon_url
チャンネルアイコン

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

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

実際に取得できるxmlについては、 https://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.nicovideo.jp/t/a/%E3%83%8B%E3%82%B3%E3%83%8B%E3%82%B3%E5%8B%95%E7%94%BBapi
ページ番号: 430 リビジョン番号: 2619054
読み:ニコニコドウガエーピーアイ
初版作成日: 08/05/13 22:25 ◆ 最終更新日: 18/08/26 08:15
編集内容についての説明/コメント: httpsに対応したAPIのURL変更・その他修正
記事編集 / 編集履歴を閲覧
このエントリーをはてなブックマークに追加

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

お絵カキコがありません

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

ピコカキコがありません

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

90 : ななしのよっしん :2018/03/19(月) 13:56:05 ID: 7e3AZRJSHb
マイリスト一覧xmlでしか取得できんみたいだけど、JSONAPIあるのかな。
91 : ななしのよっしん :2018/04/01(日) 07:25:59 ID: VZYYaidk9I
APIって5時更新じゃなかったの?
今見たらリアルタイム更新してるけど
92 : ななしのよっしん :2018/07/13(金) 06:35:54 ID: YlohyM+ola
>>86
どうしてもJSONでほしければ、VitaAPI動画VideoInfoAPIを使うという方法もある
http://api.ce.nicovideo.jp/nicoapi/v1/video.info?__format=json&v=sm123456789

ただ、生放送版のVideoInfoAPIで実験放送データを取得しようとしたら「このデバイスでは再生できない放送です」とか返されて取得できなかったので、VitaAPIゲーム機で再生できないコンテンツ情報は得られないことがあるかも?
93 : ななしのよっしん :2018/08/28(火) 09:22:13 ID: 0XzsVXfJ5V
ニコニコ科のAPI知ってるかたいます?
定したページ(存在は確実)のページIDを取得するスクリプトを書きたいんですが
HTMLスクレイビングが面倒なんで できればAPIが欲しいです。
94 : ななしのよっしん :2018/08/28(火) 09:32:04 ID: 0XzsVXfJ5V
ページIDじゃなく ページ番号でした
95 : ななしのよっしん :2018/09/02(日) 05:15:41 ID: C8guJa78xe
最近の新コメントサーバーWebSocketでも繋げられる。
new WebSocket("ws://nmsg.nicovideo.jp/websocket", "msg.nicovideo.jp#json")みたいな感じに。
実験放送サーバー動画サーバーと一緒で、昔より色々拡されてて面い。
96 : ななしのよっしん :2018/09/06(木) 23:06:09 ID: VZYYaidk9I
何をどうやったら検索できるんだ?
真っ白な画面しかでてこないんだが
http://api.search.nicovideo.jp/api/v2/snapshot/version
97 : ななしのよっしん :2018/09/07(金) 04:13:56 ID: 0XzsVXfJ5V
>>96
ちょっと失礼なこと言うが その様子だとAPIを使う意味はないと思う。
まあとりあえず
http://api.search.nicovideo.jp/api/v2/snapshot/video/contents/search?q=game&targets=title&fields=title&_sort=-viewCounter&_limit=10&_context=curl
↑ここにアクセスしてみて。URLクエリから大体推測できると思う。
ただしJSON形式で返ってくるので一般の利用者は普通検索画面から検索したらいいと思うよ。

ところでニコニコ大百科ページ番号を取得するAPIか知らないですかね
98 : ななしのよっしん :2018/09/08(土) 00:04:01 ID: LwUZ6Rj5BQ
レス番の整合性すらおぼつかないような管理放棄されたニコ百だぞ
気の利いたAPIなんかあるわけないだろ
99 : ななしのよっしん :2018/09/13(木) 01:29:00 ID: VZYYaidk9I
>>97
http://www.nicovideo.jp/search/%E3%81%82
↑これのAPI版がどんな感じで見えるのかやってみてほしい
急上昇ワード
ニコニコニューストピックス
  JASRAC許諾番号: 9013388001Y45123
  NexTone許諾番号: ID000001829