TVmaze
API serial TV: pencarian acara & orang, detail show, episode, cast, dan jadwal tayang.
Cast
TVmaze Cast — daftar lengkap pemeran satu acara TV by show ID, paginated.
/v1/movie:tvmaze/cast/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | TVmaze show ID (angka). Boleh tempel URL show TVmaze penuh — ID di-ekstrak otomatis. Required. |
| page | number | query | Nomor halaman (1, 2, 3, ...). Default 1. |
| count | number | query | Jumlah pemeran per halaman. Default 20, max 50. |
Example response
{"project":"movie:tvmaze", "data": {"page":1,"count":11, "items": [ {"gender":"Male","person":"Bryan Cranston","country":"United States","personId":14245,"character":"Walter White","personUrl":"https://www.tvmaze.com/people/14245/bryan-cranston","characterId":45529,"personImage":"https://static.tvmaze.com/uploads/images/original_untouched/195/488839.jpg","characterImage":"https://static.tvmaze.com/uploads/images/original_untouched/0/2404.jpg" }, {"gender":"Male","person":"Aaron Paul","country":"United States","personId":12328,"character":"Jesse Pinkman","personUrl":"https://www.tvmaze.com/people/12328/aaron-paul","characterId":45531,"personImage":"https://static.tvmaze.com/uploads/images/original_untouched/264/660079.jpg","characterImage":"https://static.tvmaze.com/uploads/images/original_untouched/0/2408.jpg" }, {"gender":"Female","person":"Anna Gunn","country":"United States","personId":11207,"character":"Skyler White","personUrl":"https://www.tvmaze.com/people/11207/anna-gunn","characterId":45530,"personImage":"https://static.tvmaze.com/uploads/images/original_untouched/2/6596.jpg","characterImage":"https://static.tvmaze.com/uploads/images/original_untouched/0/2409.jpg" } ],"total":11,"showId":169,"hasMore":false },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Episode
TVmaze Episode Detail — info lengkap satu episode by episode ID.
/v1/movie:tvmaze/episode/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | TVmaze episode ID (angka). Boleh tempel URL episode TVmaze penuh — ID di-ekstrak otomatis. Required. |
Example response
{"project":"movie:tvmaze", "data": {"id":12,"url":"https://www.tvmaze.com/episodes/12/under-the-dome-1x12-exigent-circumstances","name":"Exigent Circumstances","type":"regular","image":"https://static.tvmaze.com/uploads/images/original_untouched/1/4399.jpg","number":12,"rating":6.6,"season":1,"airdate":"2013-09-09","airtime":"22:00","runtime":60,"summary":"While the manhunt for Barbie continues, Big Jim gets the residents of Chester's Mill riled up and the town demands justice for all of Barbie's supposed crimes. Meanwhile, Joe and Norrie must find a new hiding place for the mini dome.","airstamp":"2013-09-10T02:00:00+00:00" },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Episodes
TVmaze Episodes — daftar episode satu acara TV by show ID, paginated.
/v1/movie:tvmaze/episodes/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | TVmaze show ID (angka). Boleh tempel URL show TVmaze penuh — ID di-ekstrak otomatis. Required. |
| season | number | query | Filter hanya episode dari season ini. Kosongkan untuk semua season. |
| page | number | query | Nomor halaman (1, 2, 3, ...). Default 1. |
| count | number | query | Jumlah episode per halaman. Default 20, max 50. |
Example response
{"project":"movie:tvmaze", "data": {"page":1,"count":7, "items": [ {"id":12192,"url":"https://www.tvmaze.com/episodes/12192/breaking-bad-1x01-pilot","name":"Pilot","type":"regular","image":"https://static.tvmaze.com/uploads/images/original_untouched/405/1012681.jpg","number":1,"rating":8.2,"season":1,"airdate":"2008-01-20","airtime":"22:00","runtime":60,"summary":"A high-school chemistry teacher (Bryan Cranston) is diagnosed with a deadly cancer, so he puts his expertise to use and teams with an ex-student (Aaron Paul) to manufacture top-gra…","airstamp":"2008-01-21T03:00:00+00:00" }, {"id":12193,"url":"https://www.tvmaze.com/episodes/12193/breaking-bad-1x02-cats-in-the-bag","name":"Cat's in the Bag...","type":"regular","image":"https://static.tvmaze.com/uploads/images/original_untouched/405/1012682.jpg","number":2,"rating":7.9,"season":1,"airdate":"2008-01-27","airtime":"22:00","runtime":60,"summary":"After the accident in the desert, Walter and Jesse need to dispose of the unfortunate mess in their rolling lab of an RV, and Skyler begins to suspect that Walter and Jesse are inv…","airstamp":"2008-01-28T03:00:00+00:00" }, {"id":12194,"url":"https://www.tvmaze.com/episodes/12194/breaking-bad-1x03-and-the-bags-in-the-river","name":"...and the Bag's in the River","type":"regular","image":"https://static.tvmaze.com/uploads/images/original_untouched/405/1012683.jpg","number":3,"rating":8.1,"season":1,"airdate":"2008-02-10","airtime":"22:00","runtime":60,"summary":"Walter and Jesse fight about the latter's drug use, so he leaves, forcing Walter to deal with their captive, Krazy-8 (Max Arciniega); Hank uses scared-straight tactics with Walter …","airstamp":"2008-02-11T03:00:00+00:00" } ],"total":7,"season":1,"showId":169,"hasMore":false },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Person
TVmaze Person Detail — info orang (aktor/kru) by person ID + kredit perannya.
/v1/movie:tvmaze/person/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | TVmaze person ID (angka). Boleh tempel URL people TVmaze penuh — ID di-ekstrak otomatis. Required. |
Example response
{"project":"movie:tvmaze", "data": {"id":14245,"url":"https://www.tvmaze.com/people/14245/bryan-cranston","name":"Bryan Cranston","image":"https://static.tvmaze.com/uploads/images/original_untouched/195/488839.jpg","gender":"Male","country":"United States","birthday":"1956-03-07", "castCredits": [ {"show":"Breaking Bad","showId":169,"character":"Walter White","characterId":45529 }, {"show":"Malcolm in the Middle","showId":568,"character":"Hal","characterId":86111 }, {"show":"North and South","showId":1157,"character":"Col. Austin","characterId":92005 }, {"show":"SuperMansion","voice":true,"showId":2743,"character":"Titanium Rex","characterId":174731 }, {"show":"Big History","voice":true,"showId":4547,"character":"Narrator","characterId":175739 }, {"show":"From the Earth to the Moon","showId":7397,"character":"Edwin 'Buzz' Aldrin","characterId":194302 }, {"show":"Your Honor","showId":32791,"character":"Judge Michael Desiato","characterId":592599 }, {"show":"Breaking Bad: Original Minisodes","showId":27845,"character":"Walter White","characterId":753117 }, {"self":true,"show":"Alien Deep with Bob Ballard","voice":true,"showId":27497,"character":"Narrator","characterId":974738 }, {"show":"History's Biggest Secrets","voice":true,"showId":73818,"character":"Narrator","characterId":1203445 }, {"show":"Malcolm in the Middle: Life's Still Unfair","showId":90782,"character":"Hal","characterId":1505449 } ],"creditCount":11 },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Schedule
TVmaze Schedule — jadwal tayang episode TV pada tanggal & negara tertentu.
/v1/movie:tvmaze/scheduleParameters
| Name | Type | In | Description |
|---|---|---|---|
| country | string | query | Kode negara ISO 2-huruf untuk jadwal TV broadcast (mis. US, GB, ID). Diabaikan kalau web=true. Default US. |
| date | string | query | Tanggal jadwal format YYYY-MM-DD. Default hari ini. |
| web | boolean | query | true=jadwal streaming/web channel (global, tanpa negara), false=jadwal TV broadcast. Default false. |
| limit | number | query | Jumlah hasil maksimum. Default 30, max 50. |
Example response
{"project":"movie:tvmaze", "data": {"date":"2024-01-01","mode":"web","count":30, "items": [ {"show":"Bored", "genres": [ "Comedy" ],"number":1,"season":12,"showId":91337,"airdate":"2024-01-01","episode":"How to fix an idiots computer","network":"Viva+","airstamp":"2023-12-31T23:00:00+00:00","showType":"Scripted","episodeId":3594252,"showImage":"https://static.tvmaze.com/uploads/images/original_untouched/621/1553152.jpg","episodeUrl":"https://www.tvmaze.com/episodes/3594252/bored-12x01-how-to-fix-an-idiots-computer" }, {"show":"Нежность", "genres": [ "Drama", "Comedy", "Romance" ],"number":1,"season":2,"showId":51908,"airdate":"2024-01-01","episode":"Серия 1","network":"Иви","runtime":23,"airstamp":"2024-01-01T00:00:00+00:00","showType":"Scripted","episodeId":2730586,"showImage":"https://static.tvmaze.com/uploads/images/original_untouched/282/707449.jpg","episodeUrl":"https://www.tvmaze.com/episodes/2730586/neznost-2x01-seria-1" }, {"show":"Нежность", "genres": [ "Drama", "Comedy", "Romance" ],"number":2,"season":2,"showId":51908,"airdate":"2024-01-01","episode":"Серия 2","network":"Иви","runtime":20,"airstamp":"2024-01-01T00:00:00+00:00","showType":"Scripted","episodeId":2730587,"showImage":"https://static.tvmaze.com/uploads/images/original_untouched/282/707449.jpg","episodeUrl":"https://www.tvmaze.com/episodes/2730587/neznost-2x02-seria-2" } ],"total":308 },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Search
TVmaze Search — cari TV shows dan/atau orang (aktor/kru) by keyword.
/v1/movie:tvmaze/searchParameters
| Name | Type | In | Description |
|---|---|---|---|
| q | string | query | Kata kunci pencarian: judul show TV atau nama aktor/kru. Required. |
| type | enum | query | Filter jenis hasil: all=keduanya, show=acara TV, person=orang. Default all. One of all, show, person. |
| limit | number | query | Jumlah hasil maksimum per kategori. Default 10, max 50. |
Example response
{"project":"movie:tvmaze", "data": {"type":"all","query":"breaking bad", "shows": [ {"id":169,"url":"https://www.tvmaze.com/shows/169/breaking-bad","imdb":"tt0903747","name":"Breaking Bad","type":"Scripted","ended":"2019-10-11","image":"https://static.tvmaze.com/uploads/images/original_untouched/501/1253519.jpg", "genres": [ "Drama", "Crime", "Thriller" ],"rating":9.2,"status":"Ended","network":"AMC","runtime":60,"summary":"Breaking Bad follows protagonist Walter White, a chemistry teacher who lives in New Mexico with his wife and teenage son who has cerebral palsy. White is diagnosed with Stage III c…","language":"English","premiered":"2008-01-20" }, {"id":27845,"url":"https://www.tvmaze.com/shows/27845/breaking-bad-original-minisodes","imdb":"tt2387761","name":"Breaking Bad: Original Minisodes","type":"Scripted","ended":"2011-07-11","image":"https://static.tvmaze.com/uploads/images/original_untouched/216/540867.jpg", "genres": [ "Comedy", "Crime" ],"rating":7,"status":"Ended","network":"AMC","runtime":5,"summary":"Watch Hank and Marie as they celebrate Valentine's Day in the bedroom in \"Good Cop, Bad Cop\". View a flashback to Hank and Marie's wedding as the groom discusses with Walt his last…","language":"English","premiered":"2009-02-17" }, {"id":1003,"url":"https://www.tvmaze.com/shows/1003/talking-bad","imdb":"tt3115468","name":"Talking Bad","type":"Talk Show","ended":"2013-09-29","image":"https://static.tvmaze.com/uploads/images/original_untouched/6/16586.jpg","status":"Ended","network":"AMC","runtime":30,"summary":"Talking Bad features Hardwick spending time with fans, actors, producers and tv enthusiasts, recapping the most recent Breaking Bad episode, and taking questions and comments from …","language":"English","premiered":"2013-08-11" } ],"people":[],"showCount":8,"personCount":0 },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Show
TVmaze Show Detail — info lengkap satu acara TV by ID (+ cast ringkas + jumlah season).
/v1/movie:tvmaze/show/:idParameters
| Name | Type | In | Description |
|---|---|---|---|
| id | string | path | TVmaze show ID (angka). Boleh tempel URL show TVmaze penuh — ID di-ekstrak otomatis. Required. |
Example response
{"project":"movie:tvmaze", "data": {"id":169,"url":"https://www.tvmaze.com/shows/169/breaking-bad", "cast": [ {"image":"https://static.tvmaze.com/uploads/images/original_untouched/0/2404.jpg","person":"Bryan Cranston","personId":14245,"character":"Walter White","characterId":45529 }, {"image":"https://static.tvmaze.com/uploads/images/original_untouched/0/2408.jpg","person":"Aaron Paul","personId":12328,"character":"Jesse Pinkman","characterId":45531 }, {"image":"https://static.tvmaze.com/uploads/images/original_untouched/0/2409.jpg","person":"Anna Gunn","personId":11207,"character":"Skyler White","characterId":45530 } ],"imdb":"tt0903747","name":"Breaking Bad","type":"Scripted","ended":"2019-10-11","image":"https://static.tvmaze.com/uploads/images/original_untouched/501/1253519.jpg", "genres": [ "Drama", "Crime", "Thriller" ],"rating":9.2,"status":"Ended","weight":100,"country":"United States","network":"AMC","runtime":60,"summary":"Breaking Bad follows protagonist Walter White, a chemistry teacher who lives in New Mexico with his wife and teenage son who has cerebral palsy. White is diagnosed with Stage III c…","thetvdb":81189,"language":"English", "schedule": { "days": [ "Sunday" ],"time":"22:00" },"premiered":"2008-01-20","seasonCount":5,"officialSite":"http://www.amc.com/shows/breaking-bad" },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "movie:tvmaze", "cast", { id: "169", page: 1, count: 20 });
TVmaze
API serial TV: pencarian acara & orang, detail show, episode, cast, dan jadwal tayang.
TVmaze Cast — daftar lengkap pemeran satu acara TV by show ID, paginated.
/v1/…tvmaze/cast/:idTry it
Parameters
id
string · path · required
TVmaze show ID (angka). Boleh tempel URL show TVmaze penuh — ID di-ekstrak otomatis.
page
number · query · optional
Nomor halaman (1, 2, 3, ...). Default 1.
count
number · query · optional
Jumlah pemeran per halaman. Default 20, max 50.
Example response
{"project":"movie:tvmaze", "data": {"page":1,"count":11, "items": [ {"gender":"Male","person":"Bryan Cranston","country":"United States","personId":14245,"character":"Walter White","personUrl":"https://www.tvmaze.com/people/14245/bryan-cranston","characterId":45529,"personImage":"https://static.tvmaze.com/uploads/images/original_untouched/195/488839.jpg","characterImage":"https://static.tvmaze.com/uploads/images/original_untouched/0/2404.jpg" }, {"gender":"Male","person":"Aaron Paul","country":"United States","personId":12328,"character":"Jesse Pinkman","personUrl":"https://www.tvmaze.com/people/12328/aaron-paul","characterId":45531,"personImage":"https://static.tvmaze.com/uploads/images/original_untouched/264/660079.jpg","characterImage":"https://static.tvmaze.com/uploads/images/original_untouched/0/2408.jpg" }, {"gender":"Female","person":"Anna Gunn","country":"United States","personId":11207,"character":"Skyler White","personUrl":"https://www.tvmaze.com/people/11207/anna-gunn","characterId":45530,"personImage":"https://static.tvmaze.com/uploads/images/original_untouched/2/6596.jpg","characterImage":"https://static.tvmaze.com/uploads/images/original_untouched/0/2409.jpg" } ],"total":11,"showId":169,"hasMore":false },"timestamp":"2026-06-07T23:38:00Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "movie:tvmaze", "cast", { id: "169", page: 1, count: 20 });