search_subtitles
Find subtitles for movies and TV shows using title, IMDB/TMDB IDs, file hashes, or episode details with language and format filtering.
Instructions
Search for subtitles using OpenSubtitles API with comprehensive parameter support
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ai_translated | No | Include AI translated subtitles (exclude, include, only) | |
| episode_number | No | Episode number for TV episodes | |
| foreign_parts_only | No | Include foreign parts only subtitles (exclude, include, only) | |
| hearing_impaired | No | Include hearing impaired subtitles (exclude, include, only) | |
| imdb_id | No | IMDB ID for exact movie/series matching | |
| languages | No | Comma-separated language codes (e.g., 'en,es,fr') | |
| machine_translated | No | Include machine translated subtitles (exclude, include, only) | |
| moviebytesize | No | File size in bytes for hash matching | |
| moviehash | No | OpenSubtitles file hash for exact matching | |
| order_by | No | Sort order (language, download_count, new, rating) | |
| order_direction | No | Sort direction (asc, desc) | |
| parent_imdb_id | No | Parent IMDB ID for TV series | |
| parent_tmdb_id | No | Parent TMDB ID for TV series | |
| password | No | OpenSubtitles.com password for authentication | |
| query | No | Text search query | |
| season_number | No | Season number for TV episodes | |
| tmdb_id | No | TMDB ID for exact movie/series matching | |
| trusted_sources | No | Only trusted sources (exclude, include, only) | |
| username | No | OpenSubtitles.com username for authentication | |
| year | No | Release year |
Input Schema (JSON Schema)
{
"additionalProperties": false,
"properties": {
"ai_translated": {
"description": "Include AI translated subtitles (exclude, include, only)",
"type": "string"
},
"episode_number": {
"description": "Episode number for TV episodes",
"type": "number"
},
"foreign_parts_only": {
"description": "Include foreign parts only subtitles (exclude, include, only)",
"type": "string"
},
"hearing_impaired": {
"description": "Include hearing impaired subtitles (exclude, include, only)",
"type": "string"
},
"imdb_id": {
"description": "IMDB ID for exact movie/series matching",
"type": "number"
},
"languages": {
"description": "Comma-separated language codes (e.g., 'en,es,fr')",
"type": "string"
},
"machine_translated": {
"description": "Include machine translated subtitles (exclude, include, only)",
"type": "string"
},
"moviebytesize": {
"description": "File size in bytes for hash matching",
"type": "number"
},
"moviehash": {
"description": "OpenSubtitles file hash for exact matching",
"type": "string"
},
"order_by": {
"description": "Sort order (language, download_count, new, rating)",
"type": "string"
},
"order_direction": {
"description": "Sort direction (asc, desc)",
"type": "string"
},
"parent_imdb_id": {
"description": "Parent IMDB ID for TV series",
"type": "number"
},
"parent_tmdb_id": {
"description": "Parent TMDB ID for TV series",
"type": "number"
},
"password": {
"description": "OpenSubtitles.com password for authentication",
"type": "string"
},
"query": {
"description": "Text search query",
"type": "string"
},
"season_number": {
"description": "Season number for TV episodes",
"type": "number"
},
"tmdb_id": {
"description": "TMDB ID for exact movie/series matching",
"type": "number"
},
"trusted_sources": {
"description": "Only trusted sources (exclude, include, only)",
"type": "string"
},
"username": {
"description": "OpenSubtitles.com username for authentication",
"type": "string"
},
"year": {
"description": "Release year",
"type": "number"
}
},
"type": "object"
}