HuluトップタイトルAPI

Huluの人気・トレンド作を特化APIで解き放て。トップ映画・番組の詳細。分析・おすすめ・娯楽プラットフォームに最適。

🎯 主な機能

• トップ集中：人気・トレンドの厳選データ
• 豊富なメタデータ：評価・ジャンル・視聴指標
• シンプル統合：率直なエンドポイント
• 柔軟な検索：名前でページング付き検索
• ランダム発見：高評価のランダム探索

📚 APIエンドポイント

Huluトップ一覧

GET /v1/hulu-top

名前フィルタ任意のページング一覧。

パラメータ：

• name (string)：名前でフィルタ
• page (integer, default: 1)：ページ番号

ランダムトップ

GET /v1/hulu-top/random

トップのランダムコンテンツ。トレンド特集に最適。

📊 レスポンスデータ

タイトルは以下を含む：

• title：映画・番組のタイトル
• type：種別（映画/番組）
• description：あらすじ
• releaseYear：公開年
• ageCertification：年齢区分
• runtime：上映時間（分）
• genres：ジャンル
• productionCountries：製作地
• seasons：シーズン数（番組）
• imdbId：IMDB識別子
• imdbScore：IMDBスコア
• imdbVotes：IMDB投票数
• tmdbPopularity：TMDB人気度
• tmdbScore：TMDBスコア

🔐 認証

認証つき安全アクセス。APIRobotsへ鍵を請求。

⚡ エラー

• 200：成功
• 400：不正な要求
• 401：未認証
• 403：禁止
• 404：未検出
• 500：内部エラー

💡 用途

• トレンドプラットフォーム
• トップ映画・番組リスト
• 人気度おすすめ
• エンタメ分析
• 動向トラック