TVer APIリファレンス - dongaba/TVerRec GitHub Wiki
TVerRec は TVerの API を呼び出すことで番組の一覧や情報を取得しています。 このページでは分かっている範囲で TVerの API (及びいくつかの静的情報取得 URL)のリファレンスを整理します。 私一人で解析できる API には限りがあるので、ご協力いただける方は更新・追記をお願いします。
TVerの番組データは以下のような階層構造で管理されています。
シリーズ
└シーズン
└エピソード
└タレント
相棒を例に説明すると以下のようになります。
- シリーズ : 相棒
- シーズン : season21、season20、season19 など
- エピソード : 第 1 話、第 2 話、第 3 話など
- タレント : 水谷豊、寺脇康文など
シリーズ、シーズン、エピソード、タレントはそれぞれ固有の ID を持っており、TVerRec では便宜上それらをシリーズ ID、シーズン ID、エピソード ID、タレント ID と定義し、番組のダウンロードを行う際のキーワードファイルで使用しています。
また、それぞれの番組は以下のようなメタデータを持っており、メタデータの一部はタグとしても設定されているため、タグを使って番組を検索することができます。
- ジャンル
- 放送局
- 放送日
- 配信開始日時
- 配信終了日
- 字幕提供の有無
- などなど
かつては使用可能なタグを一覧取得することができましたが、現在は主要なタグしか取得することができません。
過去に取得したタグの一覧は同梱するkeyword.sample.confに記載されています。
以下に挙げる API は、上記のシリーズ ID、シーズン ID、エピソード ID、タレント ID、タグ等を駆使して番組の一覧を取得することや出演タレントを取得するために使用することができます。
- ホーム画面取得API
- タグ検索API
- フリーワード検索API
- シリーズ情報取得API
- シリーズからシーズン取得API
- シーズンからエピソード取得API
- 番組情報取得API
- 番組出演タレント取得API
- タレント情報取得API
- タレント出演番組取得API
設定取得API