ニコニコAPIリストwiki

getthumbinfo

最終更新:

nicoapi

- view
だれでも歓迎! 編集
[Web API, 非ログイン可]

getthumbinfo

サムネール情報をとるのに使う。概要的な内容が必要な場合、重宝する?

リクエスト URL

  • video_id
        動画 ID

データ形式

XML 形式。
  • nicovideo_thumb_response
    status
        ok または fail
    • thumb
      • video_id
            ID
      • title
            題名
      • description
            説明文
      • thumbnail_url
            サムネールの URL
      • first_retrieve
            投稿日時
      • length
            再生時間
      • movie_type
            flv, mp4, swf の 3 種類。形式
      • size_high
            データ サイズ
      • size_low
            低画質時のデータ サイズ
      • view_counter
            再生数
      • comment_num
            コメント数
      • mylist_counter
            マイリスト数
      • last_res_body
            最新コメント
      • watch_url
            視聴ページの URL
      • thumb_type
            video または mymemory
      • embeddable
            外部プレイヤーで再生可能か
      • no_live_play
            生放送プレイヤーで再生不可能か
      • tags
            タグ一覧
        domain
            言語
        • tag
              タグ
          category
              [省略可] カテゴリー ロックあれているか
          lock
              [省略可] タグ ロックされているか
      • user_id
            ユーザー投稿動画のみ存在する。ユーザー ID
      • user_nickname
            同上。ユーザー名
      • user_icon_url
            同上。ユーザー アイコン URL
      • ch_id
            チャンネル投稿動画のみ存在する。チャンネル ID
      • ch_name
            同上。チャンネル名
      • ch_icon_url
            同上。チャンネル アイコン URL

データサンプル

ユーザー投稿動画の場合

テストする場合に、length が長時間 (119:29) の場合を考慮すること。
<?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-skr2.smilevideo.jp/smile?i=9</thumbnail_url>
    <first_retrieve>2007-03-06T00:33:00+09:00</first_retrieve>
    <length>5:19</length>
    <movie_type>flv</movie_type>
    <size_high>21138631</size_high>
    <size_low>17436492</size_low>
    <view_counter>13831185</view_counter>
    <comment_num>4176155</comment_num>
    <mylist_counter>148424</mylist_counter>
    <last_res_body>悪霊☯退散 よし行くか! ちょっとQK これくっそ寒い うううううううううう </last_res_body>
    <watch_url>http://www.nicovideo.jp/watch/sm9</watch_url>
    <thumb_type>video</thumb_type>
    <embeddable>1</embeddable>
    <no_live_play>0</no_live_play>
    <tags domain="jp">
      <tag lock="1">陰陽師</tag>
      <tag lock="1">レッツゴー!陰陽師</tag>
      <tag lock="1">公式</tag>
      <tag lock="1">音楽</tag>
      <tag lock="1">ゲーム</tag>
      <tag>最古の動画</tag>
      <tag>sm9</tag>
      <tag>→sm13</tag>
      <tag>運営長の中の人</tag>
      <tag>元気の出る動画</tag>
    </tags>
    <user_id>4</user_id>
    <user_nickname>運営長の中の人</user_nickname>
    <user_icon_url>http://usericon.nimg.jp/usericon/s/0/4.jpg?1390830505</user_icon_url>
  </thumb>
</nicovideo_thumb_response>

チャンネル投稿動画の場合

<?xml version="1.0" encoding="UTF-8"?>
<nicovideo_thumb_response status="ok">
  <thumb>
    <video_id>so22734676</video_id>
    <title>魔法戦争 第1話「真夏の魔法少女」</title>
    <description>ある夏の日のこと。七瀬武は部室棟で、見たことがない制服を着た少女・相羽六が倒れるのを目撃する。意識を失いかけている六を介抱するため、保健室まで運ぶ武だったが、意識が戻った六に不審者と勘違いされてしまう。お互いの立場の違いか、今ひとつかみ合わない会話の中、何とか誤解は解けそうになるも、そこに怪しい集団が現われ六を連れ去ろうとするのだった。原作ノベル・コミック版が今すぐ読める動画一覧はこちら</description>
    <thumbnail_url>http://tn-skr1.smilevideo.jp/smile?i=22734676</thumbnail_url>
    <first_retrieve>2014-01-27T00:00:00+09:00</first_retrieve>
    <length>24:16</length>
    <movie_type>mp4</movie_type>
    <size_high>151848175</size_high>
    <size_low>51647683</size_low>
    <view_counter>112797</view_counter>
    <comment_num>15890</comment_num>
    <mylist_counter>1357</mylist_counter>
    <last_res_body>有料 opとEDは良いけど内容 この鈴村のキャラよく ... </last_res_body>
    <watch_url>http://www.nicovideo.jp/watch/1390532934</watch_url>
    <thumb_type>video</thumb_type>
    <embeddable>1</embeddable>
    <no_live_play>0</no_live_play>
    <tags domain="jp">
      <tag category="1" lock="1">アニメ</tag>
      <tag lock="1">魔法戦争</tag>
      <tag lock="1">宮野真守</tag>
      <tag lock="1">東山奈央</tag>
      <tag lock="1">瀬戸麻沙美</tag>
      <tag lock="1">鈴村健一</tag>
      <tag>SHINAI</tag>
    </tags>
    <ch_id>2585303</ch_id>
    <ch_name>魔法戦争</ch_name>
    <ch_icon_url>http://icon.nimg.jp/channel/s/ch2585303.jpg?1390532933</ch_icon_url>
  </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>

コミュニティー限定動画の場合

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

見つからない動画の場合

<?xml version="1.0" encoding="UTF-8"?>
<nicovideo_thumb_response status="fail">
  <error>
    <code>NOT_FOUND</code>
    <description>not found or invalid</description>
  </error>
</nicovideo_thumb_response>

更新履歴

2014/2/6 記述