An Unofficial API for 1337x, Piratebay, Nyaasi, Torlock, Torrent Galaxy, Zooqle, Kickass, Bitsearch, and MagnetDL

Neeraj Kumar

Last update: Dec 27, 2022

Related tags

Third-party APIs Wrappers scraping torrents torrent-api kickass-api torlock-api 1337x-api torrent-galaxy piratebay-api nyaasi-api magnetdl-api zooqle-api bitsearch-api

Overview

Torrents Api ✨

An Unofficial API for 1337x, Piratebay, Nyaasi, Torlock, Torrent Galaxy, Zooqle, Kickass, Bitsearch, and MagnetDL

Installation

# Clone the repo
$ git clone https://github.com/Ryuk-me/Torrent-Api-py

# Install Depedencies
$ pip install -r requirements.txt

# Install Redis
> Windows user (use ubuntu terminal)
$ sudo apt-get install redis

# Start redis server
$ redis-server

# Start
$ uvicorn main:app

Setup Env File

# Change Environment variables

Go to .env file and add the following

## Get it from https://redistogo.com/
REDIS_URI=redis://redistogo:[email protected]:10393/
CACHE_EXPIRATION=180 #set cache expire time in seconds default is 180
PYTHON_ENV=prod (if you are hosting)
PYTHON_ENV=dev (if running local)

Supported Sites

Website	Keyword	Url	Cloudfare
1337x	`1337x`	https://1337xx.to	❌
Torrent Galaxy	`tgx`	https://torrentgalaxy.to	❌
Torlock	`torlock`	https://www.torlock.com	❌
PirateBay	`piratebay`	https://thepiratebay10.org	❌
Nyaasi	`nyaasi`	https://nyaa.si	❌
Zooqle	`zooqle`	https://zooqle.com	❌
KickAss	`kickass`	https://kickasstorrents.to	❌
Bitsearch	`bitsearch`	https://bitsearch.to	❌
MagnetDL	`magnetdl`	https://www.magnetdl.com	✅

Supported Methods and categories

{
        "1337x": {
            "trending_available": True,
            "trending_category": True,
            "search_by_category": True,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv","apps","documentaries", "other", "xxx", "movies"]
        },
        "torlock": {
            "trending_available": True,
            "trending_category": True,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv","apps", "documentaries", "other", "xxx", "movies", "books", "images"]
        },
        "zooqle": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": False,
            "recent_category_available": False,
            "categories": []
        },
        "magnetdl": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["apps", "movies", "music", "games", "tv", "books"]
        },
        "tgx": {
            "trending_available": True,
            "trending_category": True,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv",
                           "apps", "documentaries", "other", "xxx", "movies", "books"]
        },
        "nyaasi": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": False,
            "categories": []
        },
        "piratebay": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["tv"]
        },
        "bitsearch": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": False,
            "recent_category_available": False,
            "categories": []
        },
        "kickass": {
            "trending_available": True,
            "trending_category": True,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv","apps", "documentaries", "other", "xxx", "movies", "books"]
        }

    }

API Endpoints

api/v1/search

Parameter	Required	Type	Default	Example
site	✅	string	None	`api/v1/search?site=1337x`
query	✅	string	None	`api/v1/search?site=1337x&query=avengers`
page	❌	integer	1	`api/v1/search?site=1337x&query=avengers&page=2`

Trending

api/v1/trending

Parameter	Required	Type	Default	Example
site	✅	string	None	`api/v1/trending?site=1337x`
category	❌	string	None	`api/v1/trending?site=1337x&category=tv`
page	❌	integer	1	`api/v1/trending?site=1337x&category=tv&page=2`

Recent

api/v1/recent

Parameter	Required	Type	Default	Example
site	✅	string	None	`api/v1/recent?site=1337x`
category	❌	string	None	`api/v1/recent?site=1337x&category=tv`
page	❌	integer	1	`api/v1/recent?site=1337x&category=tv&page=2`

Search By Category

api/v1/category

Parameter	Required	Type	Default	Example
site	✅	string	None	`api/v1/category?site=1337x`
query	✅	string	None	`api/v1/category?site=1337x&query=avengers`
category	✅	string	None	`api/v1/category?site=1337x&query=avengers&category=movies`
page	❌	integer	1	`api/v1/category?site=1337x&query=avengers&category=tv&page=2`

Want to Try api ?

https://torrents-api-py3.herokuapp.com/api/v1/search?site=1337x&query=eternals

{
  "data": [
    {
      "name": "Eternals.2021.1080p.WEBRip.DDP5.1.x264-NOGRP",
      "size": "5.6 GB",
      "date": "Jan. 11th '22",
      "seeders": "10872",
      "leechers": "6820",
      "url": "https://1337xx.to/torrent/5110260/Eternals-2021-1080p-WEBRip-DDP5-1-x264-NOGRP/",
      "uploader": "TheMorozko",
      "screenshot": [
        "https://checkmy.pictures/images/2022/01/11/32162343474810151667.th.jpg",
        "https://checkmy.pictures/images/2022/01/11/38515612831471833686.th.jpg",
        "https://checkmy.pictures/images/2022/01/11/71518482909886223945.th.jpg"
      ],
      "category": "Movies",
      "poster": "https://1337xx.to/img/movie/Eternals-2021.jpg",
      "magnet": "magnet:?xt=urn:btih:A2AD2A669250A014BED19919E6C386DD4F82A883&dn=Eternals.2021.1080p.WEBRip.DDP5.1.x264-NOGRP&tr=http%3A%2F%2Ftracker.trackerfix.com%3A80%2Fannounce&tr=udp%3A%2F%2F9.rarbg.me%3A2950%2Fannounce&tr=udp%3A%2F%2F9.rarbg.to%3A2870%2Fannounce&tr=udp%3A%2F%2Ftracker.tallpenguin.org%3A15720%2Fannounce&tr=udp%3A%2F%2Ftracker.thinelephant.org%3A12780%2Fannounce&tr=udp%3A%2F%2Ftracker.zer0day.to%3A1337%2Fannounce&tr=udp%3A%2F%2Ftracker.leechers-paradise.org%3A6969%2Fannounce&tr=udp%3A%2F%2Fcoppersurfer.tk%3A6969%2Fannounce",
      "hash": "A2AD2A669250A014BED19919E6C386DD4F82A883"
    }
  ],
  "current_page": 1,
  "total_pages": 7,
  "time": 1.276763677597046,
  "total": 20
}

Donations

If you feel like showing your appreciation for this project, then how about buying me a coffee.

You can fork the repo and deploy on VPS or deploy it on Heroku :)

Comments

Heroku Internal Server Error?

Hi,

I did fork and deploy on heroku but I'm receiving Internal Server Error when I try https://xxxxxx.herokuapp.com/api/v1/search?site=1337x&query=QxR

I would appreciate your help with this problem

Edit: İt seems same problem still occurs for me?

opened by erickyun 3
Redis issue on heruko? I dont think it got removed correctly

2022-08-19T16:35:36.663157+00:00 heroku[web.1]: State changed from crashed to starting

2022-08-19T16:35:39.386347+00:00 heroku[web.1]: Starting process with command gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app

2022-08-19T16:35:40.641048+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [4] [INFO] Starting gunicorn 20.1.0

2022-08-19T16:35:40.641501+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [4] [INFO] Listening at: http://0.0.0.0:55238 (4)

2022-08-19T16:35:40.641558+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [4] [INFO] Using worker: uvicorn.workers.UvicornWorker

2022-08-19T16:35:40.647742+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [9] [INFO] Booting worker with pid: 9

2022-08-19T16:35:40.743433+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [10] [INFO] Booting worker with pid: 10

2022-08-19T16:35:40.819807+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [11] [INFO] Booting worker with pid: 11

2022-08-19T16:35:40.833925+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [12] [INFO] Booting worker with pid: 12

2022-08-19T16:35:40.963947+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [9] [ERROR] Exception in worker process

2022-08-19T16:35:40.963983+00:00 app[web.1]: Traceback (most recent call last):

2022-08-19T16:35:40.963986+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/arbiter.py", line 589, in spawn_worker

2022-08-19T16:35:40.963987+00:00 app[web.1]: worker.init_process()

2022-08-19T16:35:40.963987+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/uvicorn/workers.py", line 66, in init_process

2022-08-19T16:35:40.963988+00:00 app[web.1]: super(UvicornWorker, self).init_process()

2022-08-19T16:35:40.963988+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/workers/base.py", line 134, in init_process

2022-08-19T16:35:40.963988+00:00 app[web.1]: self.load_wsgi()

2022-08-19T16:35:40.963989+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/workers/base.py", line 146, in load_wsgi

2022-08-19T16:35:40.963989+00:00 app[web.1]: self.wsgi = self.app.wsgi()

2022-08-19T16:35:40.963990+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/app/base.py", line 67, in wsgi

2022-08-19T16:35:40.963990+00:00 app[web.1]: self.callable = self.load()

2022-08-19T16:35:40.963990+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/app/wsgiapp.py", line 58, in load

2022-08-19T16:35:40.963990+00:00 app[web.1]: return self.load_wsgiapp()

2022-08-19T16:35:40.963991+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/app/wsgiapp.py", line 48, in load_wsgiapp

2022-08-19T16:35:40.963991+00:00 app[web.1]: return util.import_app(self.app_uri)

2022-08-19T16:35:40.963991+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/gunicorn/util.py", line 359, in import_app

2022-08-19T16:35:40.963991+00:00 app[web.1]: mod = importlib.import_module(module)

2022-08-19T16:35:40.963995+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/importlib/init.py", line 126, in import_module

2022-08-19T16:35:40.963995+00:00 app[web.1]: return _bootstrap._gcd_import(name[level:], package, level)

2022-08-19T16:35:40.963996+00:00 app[web.1]: File "", line 1050, in _gcd_import

2022-08-19T16:35:40.963996+00:00 app[web.1]: File "", line 1027, in _find_and_load

2022-08-19T16:35:40.963996+00:00 app[web.1]: File "", line 1006, in _find_and_load_unlocked

2022-08-19T16:35:40.963997+00:00 app[web.1]: File "", line 688, in _load_unlocked

2022-08-19T16:35:40.963997+00:00 app[web.1]: File "", line 883, in exec_module

2022-08-19T16:35:40.963997+00:00 app[web.1]: File "", line 241, in _call_with_frames_removed

2022-08-19T16:35:40.963997+00:00 app[web.1]: File "/app/main.py", line 12, in

2022-08-19T16:35:40.963998+00:00 app[web.1]: from fastapi_cache.backends.redis import RedisBackend

2022-08-19T16:35:40.963998+00:00 app[web.1]: File "/app/.heroku/python/lib/python3.10/site-packages/fastapi_cache/backends/redis.py", line 3, in

2022-08-19T16:35:40.963998+00:00 app[web.1]: from redis.asyncio.client import Redis

2022-08-19T16:35:40.963999+00:00 app[web.1]: ModuleNotFoundError: No module named 'redis'

2022-08-19T16:35:40.963999+00:00 app[web.1]: [2022-08-19 16:35:40 +0000] [9] [INFO] Worker exiting (pid: 9)

2022-08-19T16:35:41.146504+00:00 heroku[web.1]: State changed from starting to up

2022-08-19T16:35:41.367131+00:00 app[web.1]: [2022-08-19 16:35:41 +0000] [4] [WARNING] Worker with pid 12 was terminated due to signal 15

2022-08-19T16:35:41.368091+00:00 app[web.1]: [2022-08-19 16:35:41 +0000] [4] [WARNING] Worker with pid 11 was terminated due to signal 15

2022-08-19T16:35:41.368274+00:00 app[web.1]: [2022-08-19 16:35:41 +0000] [4] [WARNING] Worker with pid 10 was terminated due to signal 15

2022-08-19T16:35:41.464592+00:00 app[web.1]: [2022-08-19 16:35:41 +0000] [4] [INFO] Shutting down: Master

2022-08-19T16:35:41.464670+00:00 app[web.1]: [2022-08-19 16:35:41 +0000] [4] [INFO] Reason: Worker failed to boot.

2022-08-19T16:35:41.667960+00:00 heroku[web.1]: Process exited with status 3

2022-08-19T16:35:41.766381+00:00 heroku[web.1]: State changed from up to crashed

opened by carolynsteeves1 2
{"error":"website blocked change ip or domain"}

This query https://torrents-api-py3.herokuapp.com/api/v1/search?site=bitsearch&query=avengers&page=1 gives an error {"error":"website blocked change ip or domain"}.

Noticed the above error occurs when the query is a single word. The query gave true results when I tried manually in the BitSearch website, but it gives an error when the same is down through the API.

Also, API gives true results when any extra word is added and the query is modified to a non single word like "avengers 2021".

Anyway, thanks a lot for the API. Brilliant work mate 🙌🏽

opened by ShebeerPrince 2
Keyword for supported sites

There should an api keyword (can be supported_sites) which would return the list of currently supported sites. This will make an user's life lot more easier!

opened by arijit4 2
Import Error

i am facing an issue while deploying Torrents-Api-py on vps

Traceback (most recent call last): File "main.py", line 8, in from fastapi import FastAPI, Query File "/home/ubuntu/.local/lib/python3.8/site-packages/fastapi/init.py", line 7, in from .applications import FastAPI as FastAPI File "/home/ubuntu/.local/lib/python3.8/site-packages/fastapi/applications.py", line 15, in from fastapi import routing File "/home/ubuntu/.local/lib/python3.8/site-packages/fastapi/routing.py", line 21, in from fastapi import params File "/home/ubuntu/.local/lib/python3.8/site-packages/fastapi/params.py", line 4, in from pydantic.fields import FieldInfo, Undefined File "pydantic/init.py", line 2, in init pydantic.init File "pydantic/dataclasses.py", line 52, in init pydantic.dataclasses # | ImportError: cannot import name dataclass_transform

opened by mjain234 1
"Internal Server Error" returned when running example URLs

Thank you for this great api.

For the last few days I'm receiving "Internal Server Error" when running the herokuapp.com example URLs you provided (links below) Not sure if the timing coincided with recent Redis shut down (but its my understanding dependencies have already been removed)

https://torrents-api-py3.herokuapp.com/api/v1/all/search?query=avengers&limit=5 https://torrents-api-py3.herokuapp.com/api/v1/search?site=1337x&query=eternals

opened by DrummerBoyQ 1
Search limit doesn't working on nyaasi

Checked several times. Using Limit: https://torrents-api-py3.herokuapp.com/api/v1/search?site=nyaasi&query=your%20name&limit=20&page=1 Without Limit: https://torrents-api-py3.herokuapp.com/api/v1/search?site=nyaasi&query=your%20name&limit=0&page=1 Showing 75 results in the both, although using the search limit.

opened by devillD 1
Self hosting??

can i install this on my dedicated server without having to use redis or deploying to roku??

i have tried installing but i get an error for fastapi-cache2

root@server:~/Torrent-Api-py# pip3 install -r requirements.txt Collecting aiohttp (from -r requirements.txt (line 1)) Downloading https://files.pythonhosted.org/packages/f6/3b/2e3b8a5b19cdceb532c61d83077a09afe1f120cb876fb771b0ce577cc0ea/aiohttp-3.8.1-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (1.1MB) 100% |████████████████████████████████| 1.1MB 799kB/s Collecting fastapi (from -r requirements.txt (line 2)) Downloading https://files.pythonhosted.org/packages/61/0f/427f0af121b226e62237e430f5bf4485e0ae1565b3f5b782613b59f30abc/fastapi-0.78.0-py3-none-any.whl (54kB) 100% |████████████████████████████████| 61kB 5.9MB/s Collecting uvicorn[standard] (from -r requirements.txt (line 3)) Downloading https://files.pythonhosted.org/packages/a0/bb/1f93757efc22e6e047021dd10255ae471e7930cfc1676ad18b9c70de48e5/uvicorn-0.17.0-py3-none-any.whl (54kB) 100% |████████████████████████████████| 61kB 6.1MB/s Collecting beautifulsoup4 (from -r requirements.txt (line 4)) Downloading https://files.pythonhosted.org/packages/9c/d8/909c4089dbe4ade9f9705f143c9f13f065049a9d5e7d34c828aefdd0a97c/beautifulsoup4-4.11.1-py3-none-any.whl (128kB) 100% |████████████████████████████████| 133kB 5.4MB/s Collecting aioredis (from -r requirements.txt (line 5)) Downloading https://files.pythonhosted.org/packages/9b/a9/0da089c3ae7a31cbcd2dcf0214f6f571e1295d292b6139e2bac68ec081d0/aioredis-2.0.1-py3-none-any.whl (71kB) 100% |████████████████████████████████| 71kB 4.8MB/s Collecting cloudscraper (from -r requirements.txt (line 6)) Downloading https://files.pythonhosted.org/packages/85/4e/96e23b05beaa2fea2972294d7c0d73d0f055822bdb4a8ffa5f88293820ff/cloudscraper-1.2.60-py2.py3-none-any.whl (97kB) 100% |████████████████████████████████| 102kB 5.8MB/s Collecting fastapi-cache2 (from -r requirements.txt (line 7)) Could not find a version that satisfies the requirement fastapi-cache2 (from -r requirements.txt (line 7)) (from versions: ) No matching distribution found for fastapi-cache2 (from -r requirements.txt (line 7))

any help would be great thanks :)

opened by Inside4ndroid 1
ERR

Getting error from last night. Probably database wrong credentials. I tried both mine and the given one.

Log: https://gist.githubusercontent.com/devillD/bd827c22827aaee44cf16208531affcf/raw/634259843054b7acde17ab9bb96fc1912d8c7a37/api-error.txt

opened by devillD 1

Change port argument type

Hi ! Thanks for your work.

The entry point has by default a string as the port argument which leads to the following error :

Traceback (most recent call last):
  File "/usr/lib64/python3.10/logging/__init__.py", line 1100, in emit
    msg = self.format(record)
  File "/usr/lib64/python3.10/logging/__init__.py", line 943, in format
    return fmt.format(record)
  File "/usr/lib64/python3.10/logging/__init__.py", line 678, in format
    record.message = record.getMessage()
  File "/usr/lib64/python3.10/logging/__init__.py", line 368, in getMessage
    msg = msg % self.args
TypeError: %d format: a real number is required, not str
Call stack:
  File "/home/ben/Torrent-Api-py/main.py", line 233, in <module>
    uvicorn.run(app, host="0.0.0.0", port='8080')
...

Change string as a int remove the error and still works.

In main.py change the

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port='8080')

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8080)

opened by Ermite28 1

api key for description of torrent?

would be great if I also had the description for the torrent as in the avengers torrent

Doctor Strange in the Multiverse of Madness (2022)

Release ........: Doctor.Strange.in.the.Multiverse.of.Madness.2022.720p.BluRay.x264-NeZu
Release Number .: 1048
Release Date ...: 17.07.2022

Movie Info
IMDb ....: https://www.imdb.com/title/tt9419884/
Rating ..: 7.0/10 from...

opened by arijit4 1

Owner

Neeraj Kumar

PewPewPew

GitHub

The most versatile torrent leecher and youtube-dl bot for telegram

TorToolkit Telegram So basically Tortoolkit is aimed to be the most versatile torrent leecher and youtube-dl bot for telegram. This bot is highly cust

1 Nov 11, 2021

A Simple Telegram Inline Torrent Search Bot by @AbirHasan2005

61 Oct 28, 2022

this is a telegram torrent bot

owner of this repo :- AYUSH contact me :- AYUSH Slam Mirror Bot This is a telegram bot writen in python for mirroring files on the internet to our bel

237 Dec 16, 2021

Deepak Clouds Torrent is a multipurpose Telegram Bot writen in Python for mirroring files on the Internet to our beloved Google Drive.

37 Oct 28, 2022

Fetch torrent links from nyaa, according to releases by smoke index.

Nyaa - Smoke's index torrent fetcher Description This script parses the local (or online) anime release index (csv format) made by Big Smoke. And uses

21 Jun 8, 2022

Who are we? We are the Hunters of all Torrent in this world.🗡️.Fork from SlamDevs

MIRROR HUNTER This Mirror Bot is a multipurpose Telegram Bot writen in Python for mirroring files on the Internet to our beloved Google Drive. Repo la

130 May 28, 2022

Torrent-Igruha SDK Python

Простой пример использования библиотеки: Устанавливаем библиотеку python -m

2 Jun 25, 2022

An API wrapper for Henrik's Unofficial VALORANT API

ValorantAPI.py An API wrapper for Henrik's Unofficial VALORANT API Warning!! This project is still in beta and only contains barely anything yet. If y

0 Feb 4, 2022

This package accesses nitrotype's official api along with its unofficial user api

NitrotypePy This package accesses nitrotype's official api along with its unofficial user api. Currently still in development. Install To install, run

2 Sep 4, 2022

Unofficial instagram API, give you access to ALL instagram features (like, follow, upload photo and video and etc)! Write on python.

Instagram-API-python Unofficial Instagram API to give you access to ALL Instagram features (like, follow, upload photo and video, etc)! Written in Pyt