A show's cast
Who is in a show: each person with the character they play, whether they appear as themselves or as a voice, their country and a picture.
Free key and every planLive data
GEThttps://api.tvguideapi.com/v1/shows/{id}/cast
Try itRuns the real call with your key
200 OK
Parameters
| Parameter | In | Type | Required | Description | Example |
|---|---|---|---|---|---|
| id | path | string | required | The show id. Ids come from Find a show. | sh_e29nzc1x |
Cast comes from TVmaze (CC BY-SA). Listing slots joined to the show carry its id, so the cast of what is on now is one call away.
Request
curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/shows/sh_e29nzc1x/cast"
$ch = curl_init("https://api.tvguideapi.com/v1/shows/sh_e29nzc1x/cast");
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/shows/sh_e29nzc1x/cast", {
headers: { Authorization: `Bearer ${process.env.TVG_KEY}` },
});
const { data, meta } = await r.json();
import os, requests
r = requests.get(
"https://api.tvguideapi.com/v1/shows/sh_e29nzc1x/cast",
headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"},
)
data = r.json()["data"]
Sample response
{
"data": [
{
"person": {
"id": 1,
"name": "Example Actor",
"country": "GB"
},
"character": "Lead role",
"self": false,
"voice": false
}
],
"meta": {
"count": 1,
"next": null,
"took_ms": 41
}
}