本ドキュメントはうごメモはてな / Flipnote Hatena の「うごメモランキング」の情報を提供する RSS フィードについて解説するものです。
うごメモはてなのランキングデータは RSS 1.0 フィードとして提供しています。 HTTP GET によってアクセスしていただくことで、指定した期間の指定した種類のランキングのデータを取得できます。
うごメモランキングの RSS は、次の URL で提供しています。
http://flipnote.hatena.com/ranking/{期間}/{対象}.rss?mode={種別}&date={日付}&locale.region={地域}&locale.lang={言語}
利用できる組み合わせは次に示す通りです。なお、集計には時間がかかることがあり、集計対象期間の終了の直後にはデータを取得できないことがありますので、ご注意ください。
集計期間の長さと日付を指定します。
| {期間} | {日付} | 内容 |
|---|---|---|
daily | YYYYMMDD | 日ごとに集計したランキング |
weekly | YYYYWW | 週ごとに集計したランキング |
monthly | YYYYMM | 月ごとに集計したランキング |
all | 指定なし | 全期間で集計したランキング |
ここで、 YYYY は西暦年号、 MM は月 (2桁)、 DD は日 (2桁)、 WW は週 (2桁、1年の最初の週を 01 とした連番) を表します。
集計の対象と基準を指定します。
| {対象} | {種別} | 内容 |
|---|---|---|
movie | total | 総合作品ランキング |
movie | play | えつらん回数ランキング |
movie | star | ☆ユーザー数ランキング |
movie | download | ダウンロード数ランキング |
movie | child | 子作品数ランキング |
author | 指定なし | 作者ランキング |
channel | 指定なし | チャンネルランキング |
集計対象となる地域を指定します。
| {地域} | 内容 |
|---|---|
0 | 日本のランキング |
1 | 北米・南米のランキング |
2 | 欧州・オセアニアのランキング |
9 | 全世界のランキング |
RSS フィードに含める HTML データの言語を指定します。ランキングの集計対象には影響しません。
| {言語} | 内容 |
|---|---|
en | 英語 |
es | スペイン語 |
fr | フランス語 |
de | ドイツ語 |
it | イタリア語 |
ja | 日本語 |
うごメモランキングの RSS は、 RSS 1.0 形式であり、ランキングの上位の作品から順に item 要素によって含められています。各 item 要素には、ランキングの HTML 版で作品・作者・チャンネルの情報を表している部分が content:encoded 要素によって含められています。