MyCineHub API

MyCineHub exposes a lightweight public API for retrieving TV episode metadata. Responses are JSON and can be fetched from any origin.

Get Season Episodes

GET /api/season?tvId={id}&season={number}

Example:

GET /api/season?tvId=1399&season=1

Parameters

• tvId (required) — TMDB ID of the TV show (positive integer).
• season (required) — Season number (integer between 0 and 100).

Response

{
  "showId": 1399,
  "showName": "Game of Thrones",
  "seasonNumber": 1,
  "episodes": [
    {
      "id": 63056,
      "name": "Winter Is Coming",
      "episodeNumber": 1,
      "overview": "...",
      "stillPath": "/b1L7qeviV1rJwMxvMnmACBMeJVm.jpg",
      "voteAverage": 8.1,
      "airDate": "2011-04-17"
    }
  ]
}

Errors

Returns 400 for invalid parameters and 500 if the upstream metadata provider is unreachable.