3-4.人気のものから探す
AmebaVisionに投稿された動画のうち、それぞれ以下の数の多い順に、最大２０件動画情報を検索して返却するAPIです。
- 視聴回数順
- ユーザ評価（good）数順
- ユーザ評価（bad）数順
- コメント数順
- お気に入り数順
URL
- 視聴回数順
http://vision.ameba.jp/api/get/search/popular.do[?range=[取得期間]] - ユーザ評価（good）数順
http://vision.ameba.jp/api/get/search/rating.do?rating=good[&range=[取得期間]] - ユーザ評価（bad）数順
http://vision.ameba.jp/api/get/search/rating.do?rating=bad[&range=[取得期間]] - コメント数順
http://vision.ameba.jp/api/get/search/comment.do[?range=[取得期間]] - お気に入り数順
http://vision.ameba.jp/api/get/search/favorite.do[?range=[取得期間]]
リクエストパラメータ
range：
取得期間（単位：日数）たとえば range=1 とすると、APIへのリクエスト時間から１日前（24時間前）までに投稿された動画が検索対象になります。
rangeパラメータが渡されていない場合は、全ての動画が検索対象になります。
offset:
データの取得開始位置を指定できます。offset指定が「0」もしくは未指定の場合は、先頭からデータを返します。
例えば「offset=1」を指定した場合、開始位置は１番目のデータの次＝先頭から2件目 となります。
length:
データの取得件数を指定できます。lengthが未指定の場合は、それぞれのAPIのデフォルトの件数が返却されます。
各APIの一リクエストあたりに返却可能な件数を超過した値を指定した場合についても、デフォルトの件数が返却されます。
format：
返却するデータフォーマットの種類。xmlとjsonpの２種類を指定可能です。未指定の場合はxml形式でデータが返却されます。
callback：
format=jsonp の時のみ有効。jsonpのコールバック関数の名前が指定できます。JavaScriptの構文に使用できない文字列などが含まれている場合、未指定の場合はデフォルトのコールバック関数の名前（handler）になります。
要素名と内容
| title | API の名称 |
| link | API に関連するサイトのURL |
| totalCount | 現在までの総動画投稿数 ※削除された動画の数はカウントされません。 |
| tagId | 動画を一意であらわすID |
| description | 動画の解説文 |
| amebaId | 動画投稿者のアメーバID |
| ratingGood | Goodの評価数 Good/Bad評価を許可していない動画の場合は０が入ります。 |
| ratingBad | Badの評価数 Good/Bad評価を許可していない動画の場合は０が入ります。 |
| playTimeSecond | 動画の再生時間 ＭＭ:ss の形式になります。 |
| viewCount | 動画の視聴回数 |
| commentCount | コメントの投稿数 |
| favoriteCount | お気に入り数 |
| imageUrlLarge | 動画のサムネイル画像（大） |
| imageUrlMedium | 動画のサムネイル画像（中） |
| imageUrlSmall | 動画のサムネイル画像（小） |
| registDatetime | 動画の投稿日時 RFC822 で定めるフォーマットになります。 |
| elapsedTime | 動画が投稿されてから経過した日時 59分以内の場合はxx分前、23時間59分以内の場合はxx時間前、それ以降はxx日前と表示されます。 |
| player | 動画のプレイヤーを表示するためのHTMLタグ 貼り付けが許可されていない動画の場合は、playerタグは空要素になります。 |