Quick Start

GET
/search?id={tmdb_or_imdb_id}

Examples

Parameters

Param Type Description
idstringTMDB or IMDB ID (required)
seasonnumberSeason number
episodenumberEpisode number
languagestringISO 639-1 codes, comma-separated
formatstringsrt, ass, sub, vtt
encodingstringutf-8, ascii, etc.
sourcestringopensubtitles, subdl, subf2m, podnapisi, gestdown, animetosho, all
hibooleanFilter hearing-impaired subtitles
forcedbooleanFilter forced / foreign-parts-only subtitles
fpsnumberMatch subtitle FPS (0.01 tolerance)
trustedbooleanFilter provider-trusted subtitles
machineTranslatedbooleanFilter machine-translated subtitles
releasestringComma-separated release compatibility filters
filestringFilename compatibility filter
originstringComma-separated release origins
sortstringdefault, match, downloads, rating, newest

Response Metadata

All existing response keys and value types are preserved. New metadata is additive and provider-dependent values may be null.

Sync: isForced, fps, matchScore, syncConfidence, matchedBy.

Release: releaseGroup, sourceType, videoCodec, resolution, edition, discNumber, discCount.

Quality: downloadCount, rating, ratingVotes, isTrusted, isMachineTranslated, isHD, uploader, uploadDate.

Classification: languageName, languageRegion, isCommentary, isSignsAndSongs, isDualLanguage, translationType.

File analysis: duration, cueCount, lineCount, timestamps, reading speed, overlaps, invalid cues, and qualityWarnings. These are calculated when downloaded and cached.

Sources

OpenSubtitles SubDL Subf2m Podnapisi AnimeTosho Gestdown