Get TV Show by ID

This API provides comprehensive metadata for a specific TV Show. It fetches the core data (including cast and a full episode list), and seamlessly merges Torrents into their episodes.

Endpoint

POST /api/v1/tv/get

Request Parameters

The following parameters are accepted in the request body:

Field	Type	Required	Description	Example
`id`	`integer`	Yes	The unique TVMaze Show ID.	`169`

Request Examples

curl -X POST https://heavstal.com.ng/api/v1/tv/get \
-H "Content-Type: application/json" \
-H "x-api-key: <YOUR_API_KEY>" \
-d '{"id": 169}'

const response = await fetch('https://heavstal.com.ng/api/v1/tv/get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': '<YOUR_API_KEY>'
  },
  body: JSON.stringify({
    id: 169
  })
});

const res = await response.json();
console.log(res.data.name);

import { tv } from '@heavstal/api';

// Get detailed TV show info by ID
const detail = await tv.get(169);
console.log(`Show: ${detail.name} | Seasons: ${detail.seasons}`);

import requests

url = "https://heavstal.com.ng/api/v1/tv/get"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}
payload = {
    "id": 169
}

response = requests.post(url, headers=headers, json=payload)
print(response.json()["data"]["name"])

{
  "status": "success",
  "creator": "HEAVSTAL TECH",
  "cached": false,
  "cache_ttl": 86400,
  "data": {
    "id": 169,
    "imdb_id": "tt0903747",
    "name": "Breaking Bad",
    "status": "Ended",
    "genres": ["Drama", "Crime", "Thriller"],
    "rating": 9.2,
    "premiered": "2008-01-20",
    "ended": "2013-09-29",
    "language": "English",
    "network": "AMC",
    "image": "https://static.tvmaze.com/uploads/images/medium_portrait/0/2400.jpg",
    "summary": "Breaking Bad follows protagonist Walter White...",
    "seasons": 5,
    "cast": [
      {
        "name": "Bryan Cranston",
        "character": "Walter White",
        "image": "https://static.tvmaze.com/uploads/images/medium_portrait/0/1815.jpg"
      }
    ],
    "episodes": [
      {
        "id": 12273,
        "name": "Pilot",
        "season": 1,
        "number": 1,
        "airdate": "2008-01-20",
        "runtime": 60,
        "image": "https://static.tvmaze.com/uploads/images/medium_landscape/23/58482.jpg",
        "summary": "When an unassuming high school chemistry teacher discovers he has a rare form of lung cancer...",
        "torrents": [
          {
            "id": 12345,
            "title": "Breaking Bad S01E01 720p HDTV x264",
            "season": 1,
            "episode": 1,
            "quality": "720p",
            "size_bytes": 105847382,
            "seeds": 14,
            "peers": 2,
            "file_download": "https://eztvx.to/torrent/...",
            "magnet_url": "magnet:?xt=urn:btih:ABCD...",
            "hash": "ABCD1234EFGH5678"
          }
        ]
      }
    ]
  }
}

{
  "status": "error",
  "error": "TV show not found"
}