Skip to content

The open subtitle scraper for all your needs, THIS REPOSITORY IS OUT OF DATE WITH PRODUCTION IF ISSUES ARISE PLEASE TELL ME

Notifications You must be signed in to change notification settings

itzCozi/wyzie-subs

Repository files navigation

Wyzie Subs

A simple easy to use Subtitle Scraper API

Features

  • Simple: Just send a request to the API with the TMDB or IMDB ID of the movie or TV show and get the subtitles for.
  • Fast: The API is hosted on a edge cloud provider with multiple proxies for spoofing requests (response time varies).
  • Free: The API is completely free to use and has no rate limits (don't abuse this please 🙏).
  • Open-Source: The API is open-source and you can host it yourself if you want to.

Usage Example

Required Environment Variable: you need to set the PROXIES environment variable to your CORS proxies urls.

PROXIES=https://torn-unicorn.fly.dev,https://proxy.wyzie.ru

Please note: the id url parameter can be used interchangable with either a TMDB ID or an IMDB ID. It checks for "tt" to determine if it's an IMDB ID or not. Using a TMDB ID is slower as we have to request the IMDB ID from TMDB first. All parameters work with both TMDB and IMDB IDs, aswell as shows and movies.

Search by IMDB / TMDB ID

GET https://sub.wyzie.ru/search?id=872585  // Fetching subtitles for the movie "Oppenheimer" with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt1877830  // Fetching subtitles for the movie "The Batman" with the IMDB ID
GET https://sub.wyzie.ru/search?id=126506&season=1&episode=1  // Fetching subtitles for the show "Smiling Friends" S1E1 with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt2861424&season=1&episode=1  // Fetching subtitles for the show "Rick and Morty" S1E1 with the IMDB ID

Search by language

GET https://sub.wyzie.ru/search?id=872585&&language=en  // Fetching English subtitles for the movie "Oppenheimer" with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt1877830&&language=ru  // Fetching Russian subtitles for the movie "The Batman" with the IMDB ID

Search by format

Available formats are: srt, ass, vtt, txt, sub, mpl, webvtt, dfxp
GET https://sub.wyzie.ru/search?id=872585&format=srt  // Fetching subtitles in SRT format for the movie "Oppenheimer" with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt1877830&format=srt  // Fetching subtitles in SRT format for the movie "The Batman" with the TMDB ID
P.S. The reason the initial commit is so large is because I had to upload the entire project to this account from the sussy-code organization. I had to do this because the main website is hosted on private repository with a huge proxies.json file instead of env vars. This repo is also out of date with the main production one.

Wyzie Subs

A simple easy to use Subtitle Scraper API

Features

  • Simple: Just send a request to the API with the TMDB or IMDB ID of the movie or TV show and get the subtitles for.
  • Fast: The API is hosted on a edge cloud provider with multiple proxies for spoofing requests (response time varies).
  • Free: The API is completely free to use and has no rate limits (don't abuse this please 🙏).
  • Open-Source: The API is open-source and you can host it yourself if you want to.

Usage Example

Required Environment Variable: you need to set the PROXIES environment variable to your CORS proxies urls.

PROXIES=https://torn-unicorn.fly.dev,https://proxy.wyzie.ru

Please note: the id url parameter can be used interchangable with either a TMDB ID or an IMDB ID. It checks for "tt" to determine if it's an IMDB ID or not. Using a TMDB ID is slower as we have to request the IMDB ID from TMDB first. All parameters work with both TMDB and IMDB IDs, aswell as shows and movies.

Search by IMDB / TMDB ID

GET https://sub.wyzie.ru/search?id=872585  // Fetching subtitles for the movie "Oppenheimer" with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt1877830  // Fetching subtitles for the movie "The Batman" with the IMDB ID
GET https://sub.wyzie.ru/search?id=126506&season=1&episode=1  // Fetching subtitles for the show "Smiling Friends" S1E1 with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt2861424&season=1&episode=1  // Fetching subtitles for the show "Rick and Morty" S1E1 with the IMDB ID

Search by language

GET https://sub.wyzie.ru/search?id=872585&&language=en  // Fetching English subtitles for the movie "Oppenheimer" with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt1877830&&language=ru  // Fetching Russian subtitles for the movie "The Batman" with the IMDB ID

Search by format

Available formats are: srt, ass, vtt, txt, sub, mpl, webvtt, dfxp
GET https://sub.wyzie.ru/search?id=872585&format=srt  // Fetching subtitles in SRT format for the movie "Oppenheimer" with the TMDB ID
GET https://sub.wyzie.ru/search?id=tt1877830&format=srt  // Fetching subtitles in SRT format for the movie "The Batman" with the TMDB ID
P.S. The reason the initial commit is so large is because I had to upload the entire project to this account from the sussy-code organization. I had to do this because the main website is hosted on private repository with a huge proxies.json file instead of env vars. This repo is also out of date with the main production one.

About

The open subtitle scraper for all your needs, THIS REPOSITORY IS OUT OF DATE WITH PRODUCTION IF ISSUES ARISE PLEASE TELL ME

Topics

Resources

Stars

Watchers

Forks