タグによるビデオリストの取得（JSON形式）
タグによるビデオリスト取得API（JSON形式）で取得できるデータの種類を詳しくご説明します。
リクエストURL
- 「:alt」で指定したフォーマットで投稿されたビデオリストを取得します。
- 「:callback」で指定したコールバック関数名を指定することができます。alt=json-in-scriptの場合のみ有効です。
- 「:tag」で指定した文字列がタグとしてついているビデオリストを取得します。
- 「:srt」で指定したソート順でビデオリストを取得します。
- 「:pgcnf」で指定した最大取得件数でビデオリストを取得します。
- 「:recommend」に1を指定すると、おすすめのビデオリストを取得します。
リクエストパラメータ
| パラメータ | 項目名 | 説明 | 必須 | 値 | デフォルト値 |
|---|---|---|---|---|---|
| alt | フォーマット | 共通仕様の要求メッセージを参照してください。 | - | 文字列 | - |
| callback | コールバック関数名 | 共通仕様の要求メッセージを参照してください。 | - | 文字列 | - |
| tag | タグ | タグを指定してください 例：「イルカ」 ※URLEncodeする場合には、Windows-31Jで実施してください。 |
○ | 文字列 | - |
| srt | ソート順 | 以下のソート順を選択できます。 新着順：new 評価順：evaluation |
- | 文字列 | new |
| pgcnf | 最大取得件数 | 以下の最大取得件数の中から選択できます。 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 30, 40, 50, 60, 70, 80, 90, 100 |
- | 数値 | 100 |
| recommend | おすすめフラグ | "1"を指定すると、おすすめのビデオリストを取得します。 | - | 数値 | - |
レスポンス
| パラメータ | 項目名 | 値 |
|---|---|---|
| { ... } | レスポンス | オブジェクト |
| status { ... } | statusタグ内は、共通仕様の応答メッセージを参照してください。 | オブジェクト |
| result [ ... ] | 結果 | リスト |
| { ... } | ビデオ | オブジェクト |
| id | ビデオのID | 文字列 |
| title | ビデオのタイトル | 文字列 |
| user_id | ユーザーID | 文字列 |
| user_name | ユーザー名 | 文字列 |
| site_id | サイトID | 文字列 |
| upload_time | 公開日時 | 日時 |
| duration | 再生時間（秒） | 数値 |
| view_count | 再生回数 | 数値 |
| rating_avg | 評価平均点 | 数値 |
| rating_sum | 評価合計 | 数値 |
| rating_count | 評価回数 | 数値 |
| description | 説明コメント | 文字列 |
| credit | クレジット | 文字列 |
| tags [ ... ] | タグのリスト | リスト |
| { ... } | タグ | オブジェクト |
| name | タグ名 | 文字列 |
| url | タグURL | URL |
| license | CCライセンス名 | 文字列 |
| download_url | ダウンロードURL | URL |
| category_id | カテゴリID | 数値 |
| category_name | カテゴリ名 | 文字列 |
| iroha_genre_id | イロハジャンルID | 数値 |
| iroha_genre_name | イロハジャンル名 | 文字列 |
| recommend | おすすめフラグ | 真偽値 |
| thumbnail_url_medium | サムネイル画像(中)のURL 160 × 120 ピクセル |
URL |
| thumbnail_url_small | サムネイル画像(小)のURL 80 × 60 ピクセル |
URL |
| thumbnail_url_large | サムネイル画像(大)のURL 480 × 360 ピクセル |
URL |
| url | 詳細画面のURL | URL |
| p_url | プレーヤのみ画面のURL | URL |
サンプルリクエストURL
「イルカ」がタグとしてついているおすすめ「recommend=1」のビデオリストを1件「pgcnf=1」取得するには次のURLにアクセスします。
サンプルレスポンス
以下は、リクエストパラメータ「tag=イルカ」「recommend=1」「pgcnf=1」のリクエストに対するレスポンスです。
データが存在しない場合
指定したパラメータでのデータ存在しない時は下記の様な結果が返って来ます。
ステータスのコードについてはステータスコードを参照してください。
