趣味で作ってる(全部それですが)Greasemonkey用のメモ。2007年11月10日現在のニコニコ動画にある、オススメ動画検索APIについて。非公開っぽいのであまり使うと怒られる予感。
要求
メソッドはGET。URIは"http://www.nicovideo.jp/api/getrelation"に以下のパラメータをつけたもの。
- page
- 要求するページ。結果は15件ごとにページ分けされる。
- sort
- ソートに使うパラメータ。以下のいずれか。
- p
- オススメ度
- r
- コメント数
- v
- 再生数
- f
- 投稿日時
- order
- 降順ないし昇順。以下のいずれか。
- d
- 降順
- a
- 昇順
- video
- 基点となる動画のID。
例えば"http://www.nicovideo.jp/api/getrelation?page=1&sort=r&order=d&video=smXXXXXXX"はsmXXXXXXXの動画に関するオススメ動画を、コメントが少ない順にソートした場合の最初の15件までの情報を返す。
レスポンス
返り値はXML。UTF-8。ちゃんと調べてない。特にエラーが出た場合。
以下成功したっぽい場合について。
ルート要素は"related_video"。その下に"total_count"、"page_count"、"data_count"という要素がそれぞれ1つずつと、0個以上の"video"要素がある。あとrelated_video要素にはstatus属性がある(成功した場合にはokを値に持つ)。
- related_video
- ルート要素。status属性を持つ
- total_count
- 検索されたオススメ動画の総数
- page_count
- ページ分けした結果、できたページの数
- data_count
- レスポンスに含まれる動画データの個数
video要素は以下の要素を持つ。まだあるかも。
- url
- 動画(を見るページ)のURL
- thumbnail
- サムネイル画像のURL
- title
- 動画のタイトル
- view
- 再生回数
- comment
- コメント数
- length
- 動画の長さ(秒数 : 整数)
- time
- 投稿された(修正された、かも)時刻(タイムスタンプ)
