AmebaVision APIドキュメント -18ページ目

3-9.関連動画情報一覧

AmebaVisionに投稿された動画のうち、指定した動画に関連性が強い動画を最大15動画検索して返却するAPIです。検索結果の並び順は、指定した動画と関連性の強い動画の順になります。

URL

http://vision.ameba.jp/api/get/relationMovie.do?movie=[動画ID]

リクエストパラメータ

movie:

動画を一意で表すID
動画閲覧画面(http://vision.ameba.jp/watch.do?movie=xxxxx)のURLに含まれている「movie」の値と同じものになります。

movieパラメータが渡されていない場合は、エラーが返却されます。

format: 

返却するデータフォーマットの種類。xmlとjsonpの2種類を指定可能です。未指定の場合はxml形式でデータが返却されます。

callback: 

format=jsonp の時のみ有効。jsonpのコールバック関数の名前が指定できます。JavaScriptの構文に使用できない文字列などが含まれている場合、未指定の場合はデフォルトのコールバック関数の名前(handler)になります。

要素名と内容

title API の名称
link API に関連するサイトのURL
description 動画の解説文
item 動画情報
title 動画のタイトル
link 動画閲覧画面のページURL
tagId 動画を一意であらわすID
description 動画の解説文
amebaId 動画投稿者のアメーバID
ratingGood Goodの評価数
Good/Bad評価を許可していない動画の場合は0が入ります。
ratingBad Badの評価数
Good/Bad評価を許可していない動画の場合は0が入ります。
playTimeSecond 動画の再生時間
MM:ss の形式になります。
viewCount 動画の視聴回数
commentCount コメントの投稿数
favoriteCount お気に入り数
imageUrlLarge 動画のサムネイル画像(大)
imageUrlMedium 動画のサムネイル画像(中)
imageUrlSmall 動画のサムネイル画像(小)
registDatetime 動画の投稿日時
RFC822 で定めるフォーマットになります。
elapsedTime 動画が投稿されてから経過した日時
59分以内の場合はxx分前、23時間59分以内の場合はxx時間前、それ以降はxx日前と表示されます。
player 動画のプレイヤーを表示するためのHTMLタグ
貼り付けが許可されていない動画の場合は、playerタグは空要素になります。