Subtitle

OpenSubtitles-backed subtitle search and download. Find subtitles by IMDB ID, TMDB ID, or text query — then download the raw subtitle text.

How it works: Search subtitles by imdbid, tmdb_id, or text query. Filter by language, season, and episode. Use the downloadUrl from results to download the subtitle content.

Search

Search for subtitles by IMDB ID, TMDB ID, or query text. Supports movies and TV shows across all languages.

GET/v1/subtitle/search?api_key=YOUR_KEY&imdbid=tt0944947&lang=eng&season=1&episode=1By IMDB ID — Game of Thrones S01E01 English

GET/v1/subtitle/search?api_key=YOUR_KEY&tmdb_id=1396&type=series&lang=eng&season=1&episode=1By TMDB ID — Breaking Bad S01E01 English

GET/v1/subtitle/search?api_key=YOUR_KEY&query=attack on titan&lang=turBy text query — Turkish subtitles

Response Schema

[
  {
    "id": "123456",
    "fileName": "Game.of.Thrones.S01E01.eng.srt",
    "lang": "eng",
    "format": "srt",
    "downloadUrl": "https://...",
    "downloadCount": 5432,
    "score": 8.5,
    "hearingImpaired": false,
    "movieName": "Game of Thrones",
    "movieYear": "2011",
    "season": "1",
    "episode": "1",
    "imdbId": "0944947"
  }
]

Parameter	Type	Required
imdbid	string	Yes
tmdb_id	number	Yes
query	string	Yes
type	string	No
lang	string	No
season	number	No
episode	number	No

Download

Download a subtitle file by its URL (from search results). Returns raw subtitle text. Gzip is auto-decompressed.

            GET /v1/subtitle/download?api_key=YOUR_KEY&url=https://dl.opensubtitles.org/en/download/sub/123456
          

Parameter	Type	Required
url	string	Yes