新ランキングでのランキングRSS利用方法
ジャンルランキングにおけるランキングRSSについて
はじめに
ニコニコ動画では、ランキングページをRSS形式で取得できる機能を提供しています。
2019年6月の新ランキング提供開始にともない、RSSの内容・URLを変更いたします。
つきましては、本記事を通して、新しいランキングRSSの技術情報を解説させていただきます。
このドキュメントの説明
本ドキュメントは、リリースに先立ち、ランキングRSSの情報を必要とするニコニコユーザー様に向けて、事前に技術情報を解説するものです。
新しいランキング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&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>  再生:<strong class="nico-info-total-view">17,970,370</strong>  コメント:<strong class="nico-info-total-res">4,826,765</strong>  いいね!:<strong class=“nico-info-total-like”>500</strong>  マイリスト:<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>  再生:<strong class="nico-info-total-view">28,985</strong>  コメント:<strong class="nico-info-total-res">1,004</strong>  いいね!:<strong class=“nico-info-total-like”>200</strong>  マイリスト:<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 から調査したい動画のデータを取得し、期間ごとの数値の増加を比較してください。 より集計しやすくするために、「検索キーワードなしでの取得」「ジャンルごとの絞り込み」オプションもご提供しております。
更新履歴
2021年12月8日
動画のいいね数をdescription内に追加しました。