Get Movie by ID

This API provides comprehensive metadata for a specific movie. It runs concurrent requests to aggregate the movie’s details, high-res screenshots, cast list, and recommended similar movies into a single unified JSON response.

Endpoint

POST /api/v1/movies/get

Request Parameters

The following parameters are accepted in the request body:

Field	Type	Required	Description	Example
`id`	`integer`	Yes	The unique movie ID.	`11`

Request Examples

Choose your preferred method to interact with the Movie Details API:

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

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

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

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

// Get detailed movie info by ID
const detail = await movies.get(11);
console.log(`Title: ${detail.title} | Rating: ${detail.rating}`);

import requests

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

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

{
  "status": "success",
  "creator": "HEAVSTAL TECH",
  "cached": false,
  "cache_ttl": 86400,
  "data": {
    "id": 11,
    "title": "13 Eerie",
    "year": 2013,
    "rating": 4.5,
    "runtime_minutes": 87,
    "genres": ["Action", "Horror", "Sci-Fi"],
    "description": "Six forensic undergrads embark on a scientific expedition...",
    "yt_trailer_code": "Mr0NM0draJo",
    "language": "en",
    "mpa_rating": "Not Rated",
    "images": {
      "background": "https://yts.gg/assets/images/movies/13_Eerie_2013/background.jpg",
      "poster": "https://yts.gg/assets/images/movies/13_Eerie_2013/large-cover.jpg",
      "screenshots": [
        "https://yts.gg/assets/images/movies/13_Eerie_2013/large-screenshot1.jpg"
      ]
    },
    "cast": [
      {
        "name": "Brendan Fehr",
        "character": "Daniel",
        "image": "https://yts.gg/assets/images/actors/thumb/nm0270451.jpg"
      }
    ],
    "torrents": [
      {
        "quality": "1080p",
        "type": "bluray",
        "size": "1.24 GB",
        "seeds": 1,
        "peers": 0,
        "file_download": "https://yts.gg/torrent/download/...",
        "magnet_url": "magnet:?xt=urn:btih:B423E5...",
        "hash": "B423E5BDFAC29096C11015DAA72401C769FFCA10"
      }
    ],
    "suggestions": [
      {
        "id": 6941,
        "title": "Flatliners",
        "year": 2017,
        "rating": 5.2,
        "poster": "https://yts.gg/assets/images/movies/flatliners_2017/medium-cover.jpg"
      }
    ]
  }
}

{
  "status": "error",
  "error": "Movie ID not found."
}