Get an episode
One TV episode: its show, season, number, name, runtime and original air date.
Free key and every planData from 1908
GEThttps://api.tvguideapi.com/v1/episodes/{id}
Try itRuns the real call with your key
200 OK
Parameters
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
| id | path | string | required | The episode id. | ep_610mmeyh |
Request
curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/episodes/ep_610mmeyh"
$ch = curl_init("https://api.tvguideapi.com/v1/episodes/ep_610mmeyh");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("TVG_KEY")],
]);
$answer = json_decode(curl_exec($ch), true);
const r = await fetch("https://api.tvguideapi.com/v1/episodes/ep_610mmeyh", {
headers: { Authorization: `Bearer ${process.env.TVG_KEY}` },
});
const { data, meta } = await r.json();
import os, requests
r = requests.get(
"https://api.tvguideapi.com/v1/episodes/ep_610mmeyh",
headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"},
)
data = r.json()["data"]
Sample response
{
"data": {
"show_id": "sh_e29nzc1x",
"episode_id": "ep_610mmeyh",
"season": 41,
"number": 157,
"name": "Episode 7012",
"orig_air": "2026-10-07",
"matched_by": "airtime",
"source": "tvmaze"
},
"meta": {
"took_ms": 23
}
}