ニコニコAPIリストwiki

getthumbinfo

最終更新：2014年05月18日 08:31

nicoapi

- view

だれでも歓迎！編集

[Web API, 非ログイン可]

getthumbinfo

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

リクエスト URL

GET http://ext.nicovideo.jp/api/getthumbinfo/{video_id}

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>