video.arrayの詳細
ブロマガの方はNsen専用みたいな感じになっちゃったので、コチラでこっそり。
主に自分用のメモ書き。
API
http://i.nicovideo.jp/v3/video.array?v=[video_id] http://i.nicovideo.jp/v3/video.array?v=[video_id],[video_id],...
使用例
http://i.nicovideo.jp/v3/video.array?v=sm9,sm13,sm14
- 一括取得できる動画数に上限はないらしいが、あまりに数が多いとタイムアウトする模様。とりあえず20〜30件ぐらいなら安定して使える。
- 存在しない動画IDを投げるとvideo_info要素を返してこない。
- so形式の動画IDを指定した場合、コメント数をchannel_threadから引っ張ってくる必要がある。
getthumbinfoとの違い
user_id、タグロック情報、ニコ生引用(no_live_play)、size_high、last_res_body、embeddableが取得できない。descriptionのHTMLタグがそのまま取得できる。※getthumbinfoでも取得できるようになりました(2013/12/20追記)- 削除動画やコミュ動画の情報も取得可能。
- so形式に統一される前に使われていた公式動画専用識別子(ax,za,ze等)は取得不能。(公式動画専用識別子については大百科記事参照->http://dic.nicovideo.jp/a/id)。
- 一部、チャンネル単位で情報取得できない動画がある(映画、ドラマ系で多い印象。getthumbinfoでは取得可)。
レスポンス例
http://i.nicovideo.jp/v3/video.array?v=so18274463
<?xml version='1.0' encoding='utf-8'?> <nicovideo_video_response status="ok"> <count>1</count> // ヒット数 <video_info> <video> <id>so18274463</id> <user_id>19087190</user_id> // ユーザーID(2014/3/7追記) <deleted>0</deleted> // 削除情報 // 0:公開、1:アップロード者削除、2:管理者削除 // 3:権利者削除、8:非表示設定 or 予約投稿 <title>【sasakure.UK×DECO*27】39【Music Video】</title> <description>初音ミク生誕5周年をお祝いするアニバーサリーソング「39(サンキュー)」のミュージック・ビデオです。<br><br><b>8月14日から9月10日まで実施される「ミク LOVES ファミマ♪ キャンペーン」のTVCMソングに決定しました!</b><br><br>───────────────────────────────<br><font color="#669900">時空を超えたUKの貴重な感謝シーン!!!!<br>\\└(感´⌒ω⌒`謝)┘// <br>たいせつなきみに、ささえてくれたみんなに、どうもありがとう。<br> <b>sasakure.UK</b></font><br><br><font color="#ff3366">たくさんの人を繋いでくれてありがとう!<br>これからもどうかよろしくね。<br>thank you, 39!!!!!!!!!!<br> <b>DECO*27</b></font><br>───────────────────────────────<br>Music by sasakure.UK<br>Lyrics by DECO*27<br>Arranged by sasakure.UK &amp; DECO*27<br><br>Guitar:DECO*27 &amp; yuxuki waga (s10rw / fhána)<br>Bass:すこっぷ<br>Drums:kous<br>Keyboards:40mP<br>Chorus:DECO*27<br>Synthesizer:sasakure.UK<br>Programming:sasakure.UK &amp; DECO*27<br><br>Concept Design:akka<br>Illustration:のん<br>Movie:hie<br><br><font color="#009966"><b>NEW!! </b>コラボ第3弾!"アオハル 0.99号"テーマソング「アオゾラハルサイト」 ▶watch/1363279524</font><br>♪コラボ第2弾!クリスマス・ソング「Snow Song Show」 ▶watch/1355246064<br>♪「39」がSEGA feat. HATSUNE MIKU Projectの数々に収録されることになりました! ▶watch/1356079385<br><br></description> <length_in_seconds>219</length_in_seconds> // 再生時間(秒) <size_low>11809680</size_low> <movie_type>mp4</movie_type> // 動画タイプ(mp4,flv,swf) <thumbnail_url>http://tn-skr4.smilevideo.jp/smile?i=18274463</thumbnail_url> // サムネ画像のURL <upload_time>2012-07-28T00:00:00+09:00</upload_time> <first_retrieve>2012-07-27T15:00:00+09:00</first_retrieve> // 投稿日時 <default_thread>1341499583</default_thread> // 通常コメントのスレッドID <view_counter>809922</view_counter> // 再生数 <mylist_counter>53316</mylist_counter> // マイリスト数 <option_flag_ichiba>0</option_flag_ichiba> <option_flag_community>1</option_flag_community> <option_flag_domestic>0</option_flag_domestic> <option_flag_comment_type>0</option_flag_comment_type> <option_flag_adult>0</option_flag_adult> // ニコニコアダルト専用? <option_flag_mobile>0</option_flag_mobile> <option_flag_economy_mp4>1</option_flag_economy_mp4> <option_flag_middle_video>1</option_flag_middle_video> <option_flag_mobile_ng_apple>0</option_flag_mobile_ng_apple> <main_category>VOCALOID</main_category> // カテゴリ(2014/3/7追記) <main_category_key>vocaloid</main_category_key>// カテゴリキー(2014/3/7追記) </video> <thread> <id>1341499583</id> // コメントのスレッドID <public>1</public> // コミュ動画における再生・コメント制限。コミュのスレッドID以外では1固定 // 1:再生は全員可、コメントは全員可 // 2:再生は全員可、コメントはメンバーのみ可 // 3:再生は全員可、コメントは全員不可 // 4:再生はメンバーのみ可、コメントはメンバーのみ可 // 5:再生はメンバーのみ可、コメントは全員不可 <num_res>2</num_res> // コメント数。 <community_id></community_id> // チャンネル・コミュ動画のスレッドIDを指定した場合のみ設定される </thread> <channel_thread> // so形式のチャンネル動画を指定した場合のみ出現(スレッドIDでは出現しない) <id>1341499584</id> // チャンネルコメントのスレッドID <num_res>41437</num_res> // チャンネルコメント数 </channel_thread> <tags> <tag_info> <tag>VOCALOID</tag> <area>jp</area> </tag_info> <tag_info> <tag>初音ミク</tag> <area>jp</area> </tag_info> <tag_info> <tag>sasakure.UK</tag> <area>jp</area> </tag_info> <tag_info> <tag>DECO*27</tag> <area>jp</area> </tag_info> <tag_info> <tag>kous</tag> <area>jp</area> </tag_info> <tag_info> <tag>yuxuki</tag> <area>jp</area> </tag_info> <tag_info> <tag>すこっぷ</tag> <area>jp</area> </tag_info> <tag_info> <tag>40mP</tag> <area>jp</area> </tag_info> <tag_info> <tag>39(サンキュー)</tag> <area>jp</area> </tag_info> <tag_info> <tag>初音ミク名曲リンク</tag> <area>jp</area> </tag_info> <tag_info> <tag>VOCALOID殿堂入り</tag> <area>jp</area> </tag_info> </tags> <video_options> // チャンネル動画だった場合のみ出現 <channel_id>171</channel_id> <permission>1</permission> // 3:コメント禁止 <title_url>http://ch.nicovideo.jp/channel/ch171</title_url> <ppv_type>0</ppv_type> // 0:無料、1:会員無料、2:有料 </video_options> </video_info> </nicovideo_video_response>
まだよく分からない要素も多いので間違っている部分があるかも。