ニコニコのイロハ1

ちまたでは色々とAPIが流行っているようですが、ニコニコ動画のAPIは一般には公開されていません。
公開すれば需要は多いと思うのですが、負荷が高くなってしまうのでしょう。
それに、動画もDL出来てしまうし。。。
しかし、一般に公開されていないだけで正規のニコニコプレイヤーが使用するAPIがあります。

少しググレば検索にヒットするし、この頃、はてぶにも結構ブックマークされているようなのですが、自分なりにまとめておきます。
最近入用なもので・・・。

とりあえずはリクエストとレスポンスをまとめておこうと思います。
間違い・不足があったらコメントに宜しくです。
動作確認には、sm9の動画を使用します。
xxxには数字が入ります。

基本的に、ニコニコのAPIを使用するにはログインが必要なのですが、ログインがいらないAPIも存在します。2つ存在するのですが、サムネイル情報の表示用と関連する動画表示ようのものです。
これらのAPIが認証を必要としないのは、あくまで想像ですが前者は外部サイトに貼り付けるサムネイル情報を表示するためにあるのと、サムネイルはキャッシュサーバなどにキャッシュされているためで、後者もキャッシュされているためではないかと思います。

今回は認証の不要なAPI2つについて書きます。

さて、まずサムネイル情報表示用のAPIと会話してみたいと思います。
ちなみに、サムネル画像へのアドレスにアクセスしても認証なしでサムネイル画像が表示されます。

http://www.nicovideo.jp/api/getthumbinfo/smxxx

・成功版

<?xml version="1.0" encoding="UTF-8"?>
  <nicovideo_thumb_response status="ok">
    <thumb>
      <video_id>sm9</video_id>
      <title>新・豪血寺一族 -煩悩解放 - レッツゴー！陰陽師</title>
      <description>レッツゴー！陰陽師（フルコーラスバージョン）</description>
      <thumbnail_url>http://tn-skr.smilevideo.jp/smile?i=9</thumbnail_url>
      <first_retrieve>2007-03-06T00:33:00+09:00</first_retrieve>
      <length>5:20</length>
      <view_counter>3417330</view_counter>
      <comment_num>2385729</comment_num>
      <mylist_counter>47711</mylist_counter>
      <last_res_body>ギターソロ：日吉若 ギターソロ：日吉若 くるのらぁ&#9829; うううううううううう </last_res_body>
      <watch_url>http://www.nicovideo.jp/watch/sm9</watch_url>
      <thumb_type>video</thumb_type>
    </thumb>
  </nicovideo_thumb_response>

・失敗版

<?xml version="1.0" encoding="UTF-8" ?> 
  <nicovideo_thumb_response status="fail">
    <error>
      <code>DELETED</code> 
      <description>deleted</description> 
    </error>
  </nicovideo_thumb_response>

・意味は

nicovideo_thumb_response status 成功どうか
video_id リクエストした動画のID
title 動画のタイトル
description 説明
thmbnail_url サムネイルのアドレス(認証なしでアクセス可)
first_retrieve 投稿日
length 再生時間
view_counter 再生数
comment_num コメント数
mylist_counter マイリスト登録数
last_res_body 最新コメント
watch_url 動画へのリンク
thumb_type 動画の種類？

次は関連する動画情報をGETしましょう。
参考にしたサイト肉少なめ | Item - ニコニコ動画メモ - オススメ動画検索API

http://www.nicovideo.jp/api/getrelation?page=x&sort=x&order=x&video=smxxx
・リクエストパラメータ

page 開始ページ数

sort

p オススメ度

r コメント数

v 再生数

f 投稿日時

order

d 降順

a 昇順

video 動画のID

.成功版(省略しています)
<?xml version="1.0" encoding="utf-8" ?> 
  <related_video status="ok">
    <total_count>103</total_count> 
    <page_count>7</page_count> 
    <data_count>15</data_count> 
      <video>
        <url>http://www.nicovideo.jp/watch/sm500873</url> 
        <thumbnail>http://tn-skr.smilevideo.jp/smile?i=500873</thumbnail> 
        <title>組曲『ニコニコ動画』</title> 
        <view>3042636</view> 
        <comment>2486434</comment> 
        <mylist>87146</mylist> 
        <length>647</length> 
        <time>1182590826</time> 
      </video>
</related_video>
・失敗版
<?xml version="1.0" encoding="utf-8" ?> 
  <related_video status="ok">
    <total_count>0</total_count> 
    <page_count>0</page_count> 
    <data_count>0</data_count> 
  </related_video>
・意味は

total_count 見つかった関連動画

page_count 総ページ数

data_countレスポンスに含まれる動画数

url 動画へのリンク

thumbnail サムネイルへのリンク

title 動画のタイトル

view 最整数

comment コメント数

mylist マイリスト登録数

length 再生時間

time 投稿時間

今回はここまでで、次回は認証が必要なAPIについて書きたいと思います。
しかし、ニコニコ動画の認証がご存知の通り2段階の認証を踏む必要があります。

でも、あきらめません。あの動画にたどり着くまでは！

まめ畑

ゆるゆると書いていきます

ニコニコのイロハ1