番組情報取得API - dongaba/TVerRec GitHub Wiki

概要

エピソード ID を使って番組情報を取得することがが可能。
番組エピソードの基本的な情報の他に、番組のシリーズ、シーズンの情報も取得可能。番組説明取得APIと類似しているが、番組シリーズ名やシーズン名、Like のカウントはこの方法でしか取得できない一方で、番組説明を取得できないなど一長一短。

メソッド

GET

エンドポイント

https://platform-api.tver.jp/service/api/v1/callEpisode/{エピソードID}

{エピソード ID}にはepで始まる 10 文字のエピソード ID を指定します。

ヘッダ

パラメータ	値	備考
x-tver-platform-type	web

パラメータ

パラメータ	値	備考
platform_uid	{platform_uid}	トークン取得 API で取得した UID
toplatform_token	{platform_token}	トークン取得 API で取得したトークン

サンプルコード

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("x-tver-platform-type", "web")
$response = Invoke-RestMethod 'https://platform-api.tver.jp/service/api/v1/callEpisode/ep1rebtxqr?platform_uid=ab41d3b879c0464d82b50f08f4001bb5d51a&platform_token=n0ts0n8ybf0vlouyp3ld8q0mk67jgfzvt811tp0t' -Method 'GET' -Headers $headers
$response | ConvertTo-Json

レスポンス

レスポンス例はこちら

{
	"api_version": "",
	"code": 0,
	"message": "",
	"type": "hasharray",
	"result": {
		"episode": {
			"type": "episode",
			"content": {
				"id": "ep1rebtxqr",
				"version": 2,
				"title": "常識を破る異色のスーパー　昭和スタイル？肉がなぜ格安？",
				"endAt": 1673013239,
				"broadcastDateLabel": "12月16日(金)放送分",
				"isNHKContent": false,
				"isSubtitle": false,
				"ribbonID": 0,
				"seriesTitle": "ガイアの夜明け",
				"isAvailable": true,
				"broadcasterName": "テレビ東京",
				"productionProviderName": "テレビ東京"
			}
		},
		"favoriteCount": 201549,
		"goodCount": 136,
		"isFavorite": false,
		"isGood": false,
		"isLater": false,
		"resume": {
			"lastViewedDuration": 0,
			"contentDuration": 2638,
			"completed": false
		},
		"season": {
			"type": "season",
			"content": {
				"id": "s0000035",
				"version": 3,
				"title": "本編"
			}
		},
		"series": {
			"type": "series",
			"content": {
				"id": "sr7x3ce7ak",
				"version": 3,
				"title": "ガイアの夜明け",
				"isNHKContent": false
			}
		}
	}
}