API version 1

Subtitles for your tool, free

JSON, UTF-8, CORS open. Base URL https://subtitlecenter.com/api/v1. No key needed to try it; a key from your account raises the limits. The OpenAPI file is at /api/openapi.yaml.

Limits

TierPer minutePer day

Anonymous, per address301,000

Registered key12020,000

Application key (open source tools, by request)600200,000

Headers X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Tier. Over the limit: 429 with Retry-After. Errors are {"error": {"code", "message"}}.

Subtitles

/subtitles?imdb_id=tt15398776&languages=bn,en by IMDb id

/subtitles?tmdb_id=872585&type=movie&languages=bn by TMDB id

/subtitles?imdb_id=tt0903747&season=2&episode=5&languages=bn one episode

/subtitles?query=Oppenheimer.2023.1080p.WEB-DL.x264-FLUX.mkv&languages=bn by release or file name, same release first

/subtitles?moviehash=8e245d9679d31e12&moviebytesize=12909756&languages=bn by video fingerprint (OpenSubtitles hash)

/subtitles/1, /subtitles/1/preview one subtitle, its first 20 cues

languages is required: our codes, ISO 639-2 or 639-3, up to ten. Filters: hi and forced (include, exclude, only), machine (default exclude), trusted_only, order (downloads, date, rating), page, per_page up to 100. Every item carries download_url; the file comes straight back, no page in between.

Catalogue

/search?q=oppenheimer&type=movie titles with per language counts; also year, language

/titles/imdb/tt15398776, /titles/tmdb/movie/872585, /titles/1

/titles/1/seasons/2, /titles/1/seasons/2/episodes/5

/languages, /stats

Rules

Say who you are in User-Agent. Cache what you can; downloads count once per address per day. Show the uploader's credit where your tool shows the file. Machine translated files are excluded unless you ask for them. The API is free and the code is AGPL-3.0; a tool that talks to it needs no licence from us.