Search, inspect and download subtitles for movies and TV from OpenSubtitles.com.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Your OpenSubtitles username; with the password, enables downloads on your account's quota
Your OpenSubtitles password
Alternative to username/password: a login token from the OpenSubtitles API
Optional own OpenSubtitles API key
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Download one subtitle file by file_id and return its text (or a temporary link), with optional format conversion, FPS conversion or time shift. Each call uses one download from the user's daily OpenSubtitles quota, so pick the file with search_subtitles first; the result reports the remaining quota.
file_id from search_subtitles or get_subtitle_details
Frame rate the subtitle was timed for (use with out_fps)
Frame rate of your video (use with in_fps)
content = return the subtitle text; link = return only a temporary download URL (for large files or saving to disk)
Shift all cues by this many seconds, e.g. 2.5 or -1
Convert to this format. Omit to keep the original (usually srt).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp-server https://mcp.opensubtitles.com/mcp
Headers
X-OpenSubtitles-Username (optional, not in the config above): Your OpenSubtitles username; with the password, enables downloads on your account's quotaX-OpenSubtitles-Password (optional, not in the config above): Your OpenSubtitles passwordX-OpenSubtitles-Token (optional, not in the config above): Alternative to username/password: a login token from the OpenSubtitles APIApi-Key (optional, not in the config above): Optional own OpenSubtitles API keyTool list last changed Nov 22, 2026.
Download one subtitle file by file_id and return its text (or a temporary link), with optional format conversion, FPS conversion or time shift. Each call uses one download from the user's daily OpenSubtitles quota, so pick the file with search_subtitles first; the result reports the remaining quota.
| Argument | Type | Description |
|---|---|---|
| in_fps | number | Frame rate the subtitle was timed for (use with out_fps) |
| file_id* | integer | file_id from search_subtitles or get_subtitle_details |
| out_fps | number | Frame rate of your video (use with in_fps) |
| delivery | string | content = return the subtitle text; link = return only a temporary download URL (for large files or saving to disk) |
| timeshift | number | Shift all cues by this many seconds, e.g. 2.5 or -1 |
| sub_format | string | Convert to this format. Omit to keep the original (usually srt). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"file_id"
],
"properties": {
"in_fps": {
"type": "number",
"maximum": 240,
"description": "Frame rate the subtitle was timed for (use with out_fps)",
"exclusiveMinimum": 0
},
"file_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "file_id from search_subtitles or get_subtitle_details",
"exclusiveMinimum": 0
},
"out_fps": {
"type": "number",
"maximum": 240,
"description": "Frame rate of your video (use with in_fps)",
"exclusiveMinimum": 0
},
"delivery": {
"enum": [
"content",
"link"
],
"type": "string",
"default": "content",
"description": "content = return the subtitle text; link = return only a temporary download URL (for large files or saving to disk)"
},
"timeshift": {
"type": "number",
"maximum": 3600,
"minimum": -3600,
"description": "Shift all cues by this many seconds, e.g. 2.5 or -1"
},
"sub_format": {
"enum": [
"srt",
"webvtt",
"sub",
"mpl",
"dfxp",
"txt"
],
"type": "string",
"description": "Convert to this format. Omit to keep the original (usually srt)."
}
}
}Full metadata for one subtitle from a search result: all files (multi-CD), uploader, comments, links, and related subtitles for the same title and language. Does not use download quota.
| Argument | Type | Description |
|---|---|---|
| language | string | The subtitle's language (speeds up the lookup) |
| feature_id* | integer | feature.feature_id of the same search result |
| subtitle_id* | any | subtitle_id from search_subtitles |
| related_limit | integer | How many related subtitles (same title and language) to return, 0-20 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subtitle_id",
"feature_id"
],
"properties": {
"language": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "The subtitle's language (speeds up the lookup)"
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "feature.feature_id of the same search result",
"exclusiveMinimum": 0
},
"subtitle_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,12}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "subtitle_id from search_subtitles"
},
"related_limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 0,
"description": "How many related subtitles (same title and language) to return, 0-20"
}
}
}The logged-in OpenSubtitles user's level, VIP status, daily download allowance and downloads remaining, so you can plan downloads. Needs a configured login; does not use quota.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Parse a movie or episode filename with guessit-js (title, year, season, episode, release group, resolution, source, codec). Offline and free; use it to build a precise search_subtitles call, or pass the filename to search_subtitles directly.
| Argument | Type | Description |
|---|---|---|
| filename* | string | e.g. "The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv" |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filename"
],
"properties": {
"filename": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "e.g. \"The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv\""
}
}
}The subtitle language codes OpenSubtitles supports (e.g. en, pt-BR, zh-CN) with their names. Use the codes in search_subtitles.languages. Also available as the opensubtitles://languages resource.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Look up movies, TV shows and episodes on OpenSubtitles (title, year, IMDb/TMDB/feature ids, seasons and episode counts, subtitle counts per language). Use it to disambiguate a title before search_subtitles, or to find a show's seasons and episodes.
| Argument | Type | Description |
|---|---|---|
| type | string | Restrict to movies, TV shows or episodes |
| year | integer | Release year |
| limit | integer | Maximum results to return (1-50) |
| query | string | Title, e.g. "Chicago Fire" |
| imdb_id | any | IMDb id (tt0133093 or 133093) |
| tmdb_id | integer | TMDB id |
| feature_id | integer | OpenSubtitles feature id |
| include_episodes | boolean | List every episode (title, feature_id, IMDb id) per season for TV shows |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"movie",
"tvshow",
"episode",
"all"
],
"type": "string",
"default": "all",
"description": "Restrict to movies, TV shows or episodes"
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1870,
"description": "Release year"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum results to return (1-50)"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title, e.g. \"Chicago Fire\""
},
"imdb_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(tt)?\\d{1,10}$"
}
],
"description": "IMDb id (tt0133093 or 133093)"
},
"tmdb_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TMDB id",
"exclusiveMinimum": 0
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "OpenSubtitles feature id",
"exclusiveMinimum": 0
},
"include_episodes": {
"type": "boolean",
"default": false,
"description": "List every episode (title, feature_id, IMDb id) per season for TV shows"
}
}
}Find subtitles for a movie or TV episode and get file_ids to download. Search by title (query), video filename, IMDb/TMDB/feature id with optional season/episode, or moviehash; filter by language and flags. Results are ranked with exact title, episode and release-name matches first.
| Argument | Type | Description |
|---|---|---|
| page | integer | Result page, starting at 1 |
| type | string | Restrict to movies or TV episodes |
| year | integer | Release year, to tell remakes and same-name titles apart |
| query | string | Title to search for, e.g. "The Matrix". Not needed when an id, moviehash or filename is given. |
| imdb_id | any | IMDb id (tt0133093 or 133093). With season_number/episode_number it is the show's id. |
| tmdb_id | integer | TMDB id. With season_number/episode_number it is the show's id. |
| filename | string | Video filename, e.g. "Chicago.Fire.S14E01.1080p.WEB.h264-ETHEL.mkv". Parsed with guessit-js into title/year/season/episode; its release name ranks matching subtitles first. |
| order_by | string | relevance = exact title/episode and release-name matches first, then popularity |
| per_page | integer | Results per page (1-100) |
| languages | array | Subtitle languages in order of preference, e.g. ["en", "pt-BR"]. Omit for all languages. |
| moviehash | string | OpenSubtitles hash of the video file (calculate_file_hash in local mode). Exact file matches are flagged moviehash_match and ranked first. |
| feature_id | integer | OpenSubtitles feature id from search_features. With season_number/episode_number it is the show's id. |
| exact_title | boolean | When searching by title, first resolve it to the exact movie/show (so "The Matrix" does not return "The Matrix Revisited"). Set false for a fuzzy text search. |
| trusted_only | boolean | Only subtitles from trusted uploaders |
| season_number | integer | TV season number; use with episode_number and the show's query or id |
| episode_number | integer | TV episode number within season_number |
| hearing_impaired | string | Subtitles for the deaf and hard of hearing (SDH) |
| foreign_parts_only | string | Subtitles that only cover foreign-language dialogue |
| include_ai_translated | boolean | Include AI-translated subtitles |
| include_machine_translated | boolean | Include machine-translated subtitles (usually low quality) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 1000,
"minimum": 1,
"description": "Result page, starting at 1"
},
"type": {
"enum": [
"movie",
"episode",
"all"
],
"type": "string",
"description": "Restrict to movies or TV episodes"
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1870,
"description": "Release year, to tell remakes and same-name titles apart"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title to search for, e.g. \"The Matrix\". Not needed when an id, moviehash or filename is given."
},
"imdb_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(tt)?\\d{1,10}$"
}
],
"description": "IMDb id (tt0133093 or 133093). With season_number/episode_number it is the show's id."
},
"tmdb_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TMDB id. With season_number/episode_number it is the show's id.",
"exclusiveMinimum": 0
},
"filename": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Video filename, e.g. \"Chicago.Fire.S14E01.1080p.WEB.h264-ETHEL.mkv\". Parsed with guessit-js into title/year/season/episode; its release name ranks matching subtitles first."
},
"order_by": {
"enum": [
"relevance",
"download_count",
"upload_date",
"rating",
"votes"
],
"type": "string",
"default": "relevance",
"description": "relevance = exact title/episode and release-name matches first, then popularity"
},
"per_page": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100)"
},
"languages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "Language code as listed by list_languages, e.g. en, de, pt-BR, zh-CN"
},
"maxItems": 20,
"minItems": 1,
"description": "Subtitle languages in order of preference, e.g. [\"en\", \"pt-BR\"]. Omit for all languages."
},
"moviehash": {
"type": "string",
"pattern": "^[0-9a-fA-F]{16}$",
"description": "OpenSubtitles hash of the video file (calculate_file_hash in local mode). Exact file matches are flagged moviehash_match and ranked first."
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "OpenSubtitles feature id from search_features. With season_number/episode_number it is the show's id.",
"exclusiveMinimum": 0
},
"exact_title": {
"type": "boolean",
"default": true,
"description": "When searching by title, first resolve it to the exact movie/show (so \"The Matrix\" does not return \"The Matrix Revisited\"). Set false for a fuzzy text search."
},
"trusted_only": {
"type": "boolean",
"default": false,
"description": "Only subtitles from trusted uploaders"
},
"season_number": {
"type": "integer",
"maximum": 999,
"minimum": 0,
"description": "TV season number; use with episode_number and the show's query or id"
},
"episode_number": {
"type": "integer",
"maximum": 9999,
"minimum": 0,
"description": "TV episode number within season_number"
},
"hearing_impaired": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Subtitles for the deaf and hard of hearing (SDH)"
},
"foreign_parts_only": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Subtitles that only cover foreign-language dialogue"
},
"include_ai_translated": {
"type": "boolean",
"default": true,
"description": "Include AI-translated subtitles"
},
"include_machine_translated": {
"type": "boolean",
"default": false,
"description": "Include machine-translated subtitles (usually low quality)"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
What changed in this server's tools since we started watching, newest first. Each change is scanned again.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"movie",
"tvshow",
"episode",
"all"
],
"type": "string",
"default": "all"
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1870
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title, e.g. \"Chicago Fire\""
},
"imdb_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(tt)?\\d{1,10}$"
}
]
},
"tmdb_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"include_episodes": {
"type": "boolean",
"default": false,
"description": "List every episode (title, feature_id, IMDb id) per season for TV shows"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"movie",
"tvshow",
"episode",
"all"
],
"type": "string",
"default": "all",
"description": "Restrict to movies, TV shows or episodes"
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1870,
"description": "Release year"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum results to return (1-50)"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title, e.g. \"Chicago Fire\""
},
"imdb_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(tt)?\\d{1,10}$"
}
],
"description": "IMDb id (tt0133093 or 133093)"
},
"tmdb_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TMDB id",
"exclusiveMinimum": 0
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "OpenSubtitles feature id",
"exclusiveMinimum": 0
},
"include_episodes": {
"type": "boolean",
"default": false,
"description": "List every episode (title, feature_id, IMDb id) per season for TV shows"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subtitle_id",
"feature_id"
],
"properties": {
"language": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "The subtitle's language (speeds up the lookup)"
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "feature.feature_id of the same search result",
"exclusiveMinimum": 0
},
"subtitle_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,12}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "subtitle_id from search_subtitles"
},
"related_limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 0
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"subtitle_id",
"feature_id"
],
"properties": {
"language": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "The subtitle's language (speeds up the lookup)"
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "feature.feature_id of the same search result",
"exclusiveMinimum": 0
},
"subtitle_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,12}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "subtitle_id from search_subtitles"
},
"related_limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 0,
"description": "How many related subtitles (same title and language) to return, 0-20"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 1000,
"minimum": 1
},
"type": {
"enum": [
"movie",
"episode",
"all"
],
"type": "string",
"description": "Restrict to movies or TV episodes"
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1870
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title to search for, e.g. \"The Matrix\". Not needed when an id, moviehash or filename is given."
},
"imdb_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(tt)?\\d{1,10}$"
}
],
"description": "IMDb id (tt0133093 or 133093). With season_number/episode_number it is the show's id."
},
"tmdb_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TMDB id. With season_number/episode_number it is the show's id.",
"exclusiveMinimum": 0
},
"filename": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Video filename, e.g. \"Chicago.Fire.S14E01.1080p.WEB.h264-ETHEL.mkv\". Parsed with guessit-js into title/year/season/episode; its release name ranks matching subtitles first."
},
"order_by": {
"enum": [
"relevance",
"download_count",
"upload_date",
"rating",
"votes"
],
"type": "string",
"default": "relevance",
"description": "relevance = exact title/episode and release-name matches first, then popularity"
},
"per_page": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"languages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "Language code as listed by list_languages, e.g. en, de, pt-BR, zh-CN"
},
"maxItems": 20,
"minItems": 1,
"description": "Subtitle languages in order of preference, e.g. [\"en\", \"pt-BR\"]. Omit for all languages."
},
"moviehash": {
"type": "string",
"pattern": "^[0-9a-fA-F]{16}$",
"description": "OpenSubtitles hash of the video file (calculate_file_hash in local mode). Exact file matches are flagged moviehash_match and ranked first."
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "OpenSubtitles feature id from search_features. With season_number/episode_number it is the show's id.",
"exclusiveMinimum": 0
},
"exact_title": {
"type": "boolean",
"default": true,
"description": "When searching by title, first resolve it to the exact movie/show (so \"The Matrix\" does not return \"The Matrix Revisited\"). Set false for a fuzzy text search."
},
"trusted_only": {
"type": "boolean",
"default": false,
"description": "Only subtitles from trusted uploaders"
},
"season_number": {
"type": "integer",
"maximum": 999,
"minimum": 0
},
"episode_number": {
"type": "integer",
"maximum": 9999,
"minimum": 0
},
"hearing_impaired": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Subtitles for the deaf and hard of hearing (SDH)"
},
"foreign_parts_only": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Subtitles that only cover foreign-language dialogue"
},
"include_ai_translated": {
"type": "boolean",
"default": true,
"description": "Include AI-translated subtitles"
},
"include_machine_translated": {
"type": "boolean",
"default": false,
"description": "Include machine-translated subtitles (usually low quality)"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 1000,
"minimum": 1,
"description": "Result page, starting at 1"
},
"type": {
"enum": [
"movie",
"episode",
"all"
],
"type": "string",
"description": "Restrict to movies or TV episodes"
},
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 1870,
"description": "Release year, to tell remakes and same-name titles apart"
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title to search for, e.g. \"The Matrix\". Not needed when an id, moviehash or filename is given."
},
"imdb_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(tt)?\\d{1,10}$"
}
],
"description": "IMDb id (tt0133093 or 133093). With season_number/episode_number it is the show's id."
},
"tmdb_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TMDB id. With season_number/episode_number it is the show's id.",
"exclusiveMinimum": 0
},
"filename": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Video filename, e.g. \"Chicago.Fire.S14E01.1080p.WEB.h264-ETHEL.mkv\". Parsed with guessit-js into title/year/season/episode; its release name ranks matching subtitles first."
},
"order_by": {
"enum": [
"relevance",
"download_count",
"upload_date",
"rating",
"votes"
],
"type": "string",
"default": "relevance",
"description": "relevance = exact title/episode and release-name matches first, then popularity"
},
"per_page": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Results per page (1-100)"
},
"languages": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$",
"description": "Language code as listed by list_languages, e.g. en, de, pt-BR, zh-CN"
},
"maxItems": 20,
"minItems": 1,
"description": "Subtitle languages in order of preference, e.g. [\"en\", \"pt-BR\"]. Omit for all languages."
},
"moviehash": {
"type": "string",
"pattern": "^[0-9a-fA-F]{16}$",
"description": "OpenSubtitles hash of the video file (calculate_file_hash in local mode). Exact file matches are flagged moviehash_match and ranked first."
},
"feature_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "OpenSubtitles feature id from search_features. With season_number/episode_number it is the show's id.",
"exclusiveMinimum": 0
},
"exact_title": {
"type": "boolean",
"default": true,
"description": "When searching by title, first resolve it to the exact movie/show (so \"The Matrix\" does not return \"The Matrix Revisited\"). Set false for a fuzzy text search."
},
"trusted_only": {
"type": "boolean",
"default": false,
"description": "Only subtitles from trusted uploaders"
},
"season_number": {
"type": "integer",
"maximum": 999,
"minimum": 0,
"description": "TV season number; use with episode_number and the show's query or id"
},
"episode_number": {
"type": "integer",
"maximum": 9999,
"minimum": 0,
"description": "TV episode number within season_number"
},
"hearing_impaired": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Subtitles for the deaf and hard of hearing (SDH)"
},
"foreign_parts_only": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Subtitles that only cover foreign-language dialogue"
},
"include_ai_translated": {
"type": "boolean",
"default": true,
"description": "Include AI-translated subtitles"
},
"include_machine_translated": {
"type": "boolean",
"default": false,
"description": "Include machine-translated subtitles (usually low quality)"
}
}
}