Wyzie Subs
Directly Fetching Wyzie Subs#
I strongly recommend using the NPM package as it is easier and more reliable.
If you have decided against using the NPM package, then let's get started. I will only be going over API parameters and data returned by the API. How you request the API is entirely up to you.
An API key is required for all requests. Get your free key at sub.wyzie.io/redeem and include it as &key=YOUR_KEY in every request. See the API Keys page for details.
Example#
{
"id": "1955024019",
"url": "https://sub.wyzie.io/c/198e0c4d/id/1955024019?format=srt&encoding=UTF-8",
"flagUrl": "https://flagsapi.com/US/flat/24.png",
"format": "srt",
"encoding": "UTF-8",
"display": "English",
"language": "en",
"media": "The Martian",
"isHearingImpaired": false,
"source": "opensubtitles",
"release": "The.Martian.2015.1080p.WEB-DL",
"releases": ["The.Martian.2015.1080p.WEB-DL"],
"fileName": "the.martian.2015.1080p.web-dl.srt",
"origin": "WEB-DL",
"matchedRelease": "The.Martian.2015.1080p.WEB-DL",
"matchedFilter": "martian"
}Parameters#
| Parameter | Example | Description |
|---|---|---|
| id | /search?id=tt3659388 or /search?id=286217 | TMDB or IMDB ID of the show or movie (required). |
| season & episode | /search?id=tt0121955&season=1&episode=1 | Season and episode for TV searches. Both must be present together. |
| language | /search?id=tt3659388&language=en,es | Language filter (ISO 639-1 codes). Multiple values are comma-separated. |
| format | /search?id=tt3659388&format=srt,ass | Subtitle formats to return. Multiple values allowed. |
| hi | /search?id=tt3659388&hi=true | Whether to prefer hearing-impaired subtitles. |
| encoding | /search?id=tt3659388&encoding=utf-8,latin-1 | Character encoding filter. |
| source | /search?id=tt3659388&source=subdl,podnapisi | Subtitle providers to query (all queries every enabled source; default opensubtitles). |
| release | /search?id=tt3659388&release=martian,1080p | Release or scene name filters (comma-separated). |
| file/fileName | /search?id=tt3659388&file=proper | Filename filters (aliases: file, filename, fileName). |
| origin | /search?id=tt3659388&origin=WEB,BLURAY | Content origin filter, comma-separated (e.g., WEB, BLURAY, DVD). |
| key | /search?id=tt3659388&key=YOUR_KEY | Your API key (required). Get one free at sub.wyzie.io/redeem. |
| refresh | /search?id=tt3659388&refresh=true | Bypass cache and fetch fresh results. Use when sources may have updated. |
When using an IMDB ID, ensure that the first two characters ('tt') are included at the beginning of the ID.
Data Returned#
| Object | Description |
|---|---|
| id | The ID of the subtitle file. |
| url | The URL to the subtitle file. |
| flagUrl | URL to the flag of the language's locale. |
| format | The format of the subtitle file. |
| encoding | The character encoding of the subtitle file. |
| display | The language of the subtitle, capitalized. |
| language | The ISO 3166-2 code of the language. |
| media | The name of the media that the subtitles are for. |
| isHearingImpaired | Boolean representing if the subtitle is hearing impaired accessible. |
| source | Which source the subtitle was scraped from. |
| release | Primary release name. |
| releases | Other release names compatible with the subtitle. |
| fileName | Original filename when available. |
| downloadCount | Number of downloads on the source platform (if available). |
| origin | Content origin (e.g., WEB, BluRay, DVD). |
| matchedRelease | Release value that matched your filter (if provided). |
| matchedFilter | The user-supplied filter that matched (if provided). |