新ランキングでのランキングRSS利用方法

ジャンルランキングにおけるランキングRSSについて

はじめに

ニコニコ動画では、ランキングページをRSS形式で取得できる機能を提供しています。

2019年6月の新ランキング提供開始にともない、RSSの内容・URLを変更いたします。
つきましては、本記事を通して、新しいランキングRSSの技術情報を解説させていただきます。

このドキュメントの説明

本ドキュメントは、リリースに先立ち、ランキングRSSの情報を必要とするniconicoユーザー様に向けて、事前に技術情報を解説するものです。
新しいランキングRSSは、ジャンルランキングのリリースと同時に利用可能になります。

ランキングRSSの概要

ランキングRSSを利用すると、ランキングページと同じ内容を、よりコンピュータで取り扱いやすいRSS形式で取得することができます。

RSSで取得できるランキングは以下の通りです。

  • 期間
    • 毎時
    • 24時間
    • 週間
    • 月間
  • ジャンル
    • ジャンルごとの総合
    • 人気のタグごと

注意事項

  • RSSに記載されている日時は、すべて日本標準時(JST)です。
  • 本RSSは、広く利用していただくため、アクセスできるユーザーに制限を設けていません。
    そのため、短時間に多量のアクセスを行った場合、正常にRSSを取得できなくなることがあります。
    また、場合によっては本データの提供を中止させていただくこともあります。ご利用の際は、負荷へのご配慮をお願いいたします。
  • 新しいRSSの配信開始にともない、これまでのRSSはアクセスできなくなります。
  • 人気のタグ以外の、任意のタグによるランキングRSS発行には対応していません。

技術情報

エンドポイント

新しいランキングRSSにアクセスするには、ランキングURLの末尾に rss=2.0&lang=ja-jp を追加してアクセスします。

https://www.nicovideo.jp/ranking/genre/{ジャンル名}?tag={タグ名}&term={集計期間}&rss=2.0&lang=ja-jp

フォーマット

新しいランキングRSSは、以下のような形式です。

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
     
      <title>動画ランキング - ニコニコ動画</title>
      <link>https://www.nicovideo.jp/ranking/genre/all?term=24h</link>
      <description>毎時更新</description>
      <pubDate>Wed, 05 Jun 2019 15:00:00 +0900</pubDate>
      <lastBuildDate>Wed, 05 Jun 2019 15:00:00 +0900</lastBuildDate>
      <generator>ニコニコ動画</generator>
      <language>ja-jp</language>
      <copyright>(c) DWANGO Co., Ltd.</copyright>
      <docs>http://blogs.law.harvard.edu/tech/rss</docs>
     
  <atom:link rel="self" type="application/rss+xml" href="https://www.nicovideo.jp/ranking/genre/all?rss=2.0&amp;lang=ja-jp"/>
 
     
                <item>
        <title>新・豪血寺一族 -煩悩解放 - レッツゴー!陰陽師</title>
        <link>https://www.nicovideo.jp/watch/sm9</link>
        <guid isPermaLink="false">tag:nicovideo.jp,2007-03-06:/watch/sm9</guid>
        <pubDate>Fri, 07 Jun 2019 06:00:00 +0900</pubDate>
        <description><![CDATA[
                      <p class="nico-thumbnail"><img alt="新・豪血寺一族 -煩悩解放 - レッツゴー!陰陽師" src="http://tn.smilevideo.jp/smile?i=9" width="94" height="70" border="0"/></p>
                                <p class="nico-description">レッツゴー!陰陽師(フルコーラスバージョン)</p>
                                <p class="nico-info"><small><strong class="nico-info-length">5:20</strong>|<strong class="nico-info-date">2007年03月06日 00:33:00</strong> 投稿<br/><strong>合計</strong>&nbsp;&#x20;再生:<strong class="nico-info-total-view">17,970,370</strong>&nbsp;&#x20;コメント:<strong class="nico-info-total-res">4,826,765</strong>&nbsp;&#x20;マイリスト:<strong class="nico-info-total-mylist">176,356</strong><br/></small></p>
                  ]]></description>
      </item>
 
                <item>
        <title>運営中曽根OFF@ニコニコ動画新サービス発表会(γ)</title>
        <link>https://www.nicovideo.jp/watch/sm17170249</link>
        <guid isPermaLink="false">tag:nicovideo.jp,2012-03-06:/watch/sm17170249</guid>
        <pubDate>Wed, 05 Jun 2019 15:00:00 +0900</pubDate>
        <description><![CDATA[
                      <p class="nico-thumbnail"><img alt="運営中曽根OFF@ニコニコ動画新サービス発表会(γ)" src="http://tn.smilevideo.jp/smile?i=17170249" width="94" height="70" border="0"/></p>
                                <p class="nico-description">2011年12月12日に5周年を迎えたニコニコ動画。原点回帰をテーマに掲げたサービス発表第3弾「ニコニコ動画5周年記念新サービス発表会(γ)」のオープニング映像です。運営一同、幕張メッセでがんばりました。</p>
                                <p class="nico-info"><small><strong class="nico-info-length">5:53</strong>|<strong class="nico-info-date">2012年03月06日 15:49:00</strong> 投稿<br/><strong>合計</strong>&nbsp;&#x20;再生:<strong class="nico-info-total-view">28,985</strong>&nbsp;&#x20;コメント:<strong class="nico-info-total-res">1,004</strong>&nbsp;&#x20;マイリスト:<strong class="nico-info-total-mylist">393</strong><br/></small></p>
                  ]]></description>
      </item>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
以下、同一の形式
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  </channel>
</rss>

FAQ

Q1. 新しいランキングRSSはいつから提供されますか?

新ランキングのリリースと同時に提供開始されます。(2019年6月中を予定しています)

Q2. これまでのRSSは引き続き取得できますか?

いいえ。新しいランキングは根本的に仕組みを変更したため、これまでのRSSで提供していた情報の一部(前回ランキング集計時との差分など)は内部的にも保存しておらず、ご提供できなくなってしまいました。 したがって、新ランキングのリリースと同時に、これまでのRSSはアクセスできなくなります。

Q3. RSSに記載されている再生数やコメント数が、アクセスするたびに増加するのですが?

はい。 これまでのランキングは、ランキング集計時の再生数・コメント数・マイリスト数がランキングページに表示されていて、実際の再生数・コメント数・マイリスト数とは異なる数値が表示されていました。

新しいランキングでは、ランキングページやランキングRSSでも、リアルタイムに再生数・コメント数・マイリスト数が反映されるようになっています。
したがって、ある程度の時間をおいてRSSを取得しなおした場合、動画の再生数・コメント数・マイリスト数が変化している可能性があります。

Q4. 自作ランキングを作成するうえで、一定期間ごと・動画ごとの再生数・コメント数・マイリスト数の増加を調べたいです。どのようにすればよいですか?

そのような用途であれば、定期的に スナップショット検索API v2 から調査したい動画のデータを取得し、期間ごとの数値の増加を比較してください。 より集計しやすくするために、「検索キーワードなしでの取得」「ジャンルごとの絞り込み」オプションもご提供しております。