Skip to content

Latest commit

 

History

History
460 lines (374 loc) · 18.2 KB

README.md

File metadata and controls

460 lines (374 loc) · 18.2 KB
Raw

Torrents Api ✨

An Unofficial API for 1337x, Piratebay, Nyaasi, Torlock, Torrent Galaxy, Zooqle, Kickass, Bitsearch, MagnetDL, Libgen, YTS, Limetorrent, TorrentFunk, Glodls, TorrentProject and YourBittorrent

Installation

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

# Go to the repository
$ cd Torrent-Api-py

# Install virtualenv
$ pip install virtualenv

# Create Virtual Env
$ py -3 -m venv api-py

# Activate Virtual Env [Windows]
$ .\api-py\Scripts\activate

# Activate Virtual Env [Linux]
$ source api-py/bin/activate

# Install Dependencies
$ pip install -r requirements.txt

# Start
$ python main.py

# (optional) To Use a PROXY, set the HTTP Proxy environment variable
# You can also use a tor proxy using dperson/torproxy:latest
$ export HTTP_PROXY="http://proxy-host:proxy-port"

# To access API Open any browser/API Testing tool & move to the given URL
$ localhost:8009

Supported Sites

Website Keyword Url Cloudfare
1337x 1337x https://1337x.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 ✅
Libgen libgen https://libgen.is ❌
YTS yts https://yts.mx ❌
Limetorrent limetorrent https://www.limetorrents.pro ❌
TorrentFunk torrentfunk https://www.torrentfunk.com ❌
Glodls glodls https://glodls.to ❌
TorrentProject torrentproject https://torrentproject2.com ❌
YourBittorrent ybt https://yourbittorrent.com ❌
Supported Methods and categories

If you want to change the default limit site wise Visit Here

{
        "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"],
            "limit" : 100
        },
        "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"],
            "limit" : 50
        },
        "zooqle": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": False,
            "recent_category_available": False,
            "categories": [],
            "limit": 30
        },
        "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"],
            "limit": 40
        },
        "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"],
            "limit": 50
        },
        "nyaasi": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": False,
            "categories": [],
            "limit": 50

        },
        "piratebay": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["tv"],
            "limit": 50
        },
        "bitsearch": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": False,
            "recent_category_available": False,
            "categories": [],
            "limit": 50
        },
        "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"],
            "limit": 50
        },
        "libgen'": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": False,
            "recent_category_available": False,
            "categories": [],
            "limit": 25
        },
        "yts": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": False,
            "categories": [],
            "limit": 20
        },
        "limetorrent": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv",
                           "apps", "other", "movies", "books"],  # applications and tv-shows
            "limit": 50
        },
        "torrentfunk": {
            "trending_available": True,
            "trending_category": True,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv",
                           "apps", "xxx", "movies", "books"],  # television # software #adult # ebooks
            "limit": 50
        },
        "glodls": {
            "trending_available": True,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": False,
            "categories": [],
            "limit": 45
        },
        "torrentproject": {
            "trending_available": False,
            "trending_category": False,
            "search_by_category": False,
            "recent_available": False,
            "recent_category_available": False,
            "categories": [],
            "limit": 20
        },
        "ybt": {
            "trending_available": True,
            "trending_category": True,
            "search_by_category": False,
            "recent_available": True,
            "recent_category_available": True,
            "categories": ["anime", "music", "games", "tv",
                           "apps", "xxx", "movies", "books", "pictures", "other"],  # book -> ebooks
            "limit": 20
        }

    }

API Endpoints

Supported sites list

api/v1/sites


Search

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
limit ❌ integer Default api/v1/search?site=1337x&query=avengers&limit=20
page ❌ integer 1 api/v1/search?site=1337x&query=avengers&limit=0&page=2


Trending

api/v1/trending

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


Recent

api/v1/recent

Parameter Required Type Default Example
site ✅ string None api/v1/recent?site=1337x
limit ❌ integer Default api/v1/recent?site=1337x&limit=7
category ❌ string None api/v1/recent?site=1337x&limit=0&category=tv
page ❌ integer 1 api/v1/recent?site=1337x&limit=15&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
limit ❌ integer Default api/v1/category?site=1337x&query=avengers&category=movies&limit=10
page ❌ integer 1 api/v1/category?site=1337x&query=avengers&category=tv&limit=0&page=2


Search from all sites

api/v1/all/search

Parameter Required Type Default Example
query ✅ string None api/v1/all/search?query=avengers
limit ❌ integer Default api/v1/all/search?query=avengers&limit=5 
Here limit = 5 will get 5 results from each site.

api/v1/all/search?query=avengers

api/v1/all/search?query=avengers&limit=5


Get trending from all sites

api/v1/all/trending

Parameter Required Type Default Example
limit ❌ integer Default api/v1/all/trending?limit=2

api/v1/all/trending

api/v1/all/trending?limit=2


Get recent from all sites

api/v1/all/recent

Parameter Required Type Default Example
limit ❌ integer Default api/v1/all/recent?limit=2

api/v1/all/recent

api/v1/all/recent?limit=2

Want to Try api ?

api/v1/search?site=1337x&query=eternals

See response 

{
  "data": [
    { 
      "name": "Eternals.2021.1080p.WEBRip.1600MB.DD5.1.x264-GalaxyRG",
      "size": "1.6 GB",
      "date": "Jan. 11th '22",
      "seeders": "3674",
      "leechers": "983",
      "url": "https://1337x.to/torrent/5110228/Eternals-2021-1080p-WEBRip-1600MB-DD5-1-x264-GalaxyRG/",
      "uploader": "TGxGoodies",
      "screenshot": [
        "https://everest.picturedent.org/images/2022/01/11/tmpposter23827.jpg",
        "https://everest.picturedent.org/images/2022/01/11/Harone8014.th.jpg",
        "https://everest.picturedent.org/images/2022/01/11/Harone31320.th.jpg",
        "https://everest.picturedent.org/images/2022/01/11/Harone8129XqiKn.th.jpg",
        "https://everest.picturedent.org/images/2022/01/11/Harone27162.th.jpg",
        "https://everest.picturedent.org/images/2022/01/11/Harone1352.th.jpg",
        "https://everest.picturedent.org/images/2022/01/11/Harone14355.th.jpg"
      ],
      "category": "Movies",
      "files": [
        "Eternals.2021.1080p.WEBRip.1600MB.DD5.1.x264-GalaxyRG.mkv (1.6 GB)",
        "[TGx]Downloaded from torrentgalaxy.to .txt (0.7 KB)"
      ],
      "poster": "https://lx1.dyncdn.cc/cdn/02/0251ab7772c031c1130bc92810758cd4.jpg",
      "magnet": "magnet:?xt=urn:btih:20F8D7C2942B143E6E2A0FB5562CDE7EE1B17822&dn=Eternals.2021.1080p.WEBRip.1600MB.DD5.1.x264-GalaxyRG&tr=udp://open.stealth.si:80/announce&tr=udp://tracker.tiny-vps.com:6969/announce&tr=udp://tracker.opentrackr.org:1337/announce&tr=udp://tracker.torrent.eu.org:451/announce&tr=udp://explodie.org:6969/announce&tr=udp://tracker.cyberia.is:6969/announce&tr=udp://ipv4.tracker.harry.lu:80/announce&tr=udp://p4p.arenabg.com:1337/announce&tr=udp://tracker.birkenwald.de:6969/announce&tr=udp://tracker.moeking.me:6969/announce&tr=udp://opentor.org:2710/announce&tr=udp://tracker.dler.org:6969/announce&tr=udp://9.rarbg.me:2970/announce&tr=https://tracker.foreverpirates.co:443/announce&tr=udp://tracker.opentrackr.org:1337/announce&tr=http://tracker.openbittorrent.com:80/announce&tr=udp://opentracker.i2p.rocks:6969/announce&tr=udp://tracker.internetwarriors.net:1337/announce&tr=udp://tracker.leechers-paradise.org:6969/announce&tr=udp://coppersurfer.tk:6969/announce&tr=udp://tracker.zer0day.to:1337/announce",
      "hash": "20F8D7C2942B143E6E2A0FB5562CDE7EE1B17822"
    }
  ],
  "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?

"Buy Me A Coffee"

DEPLOY

Deploy to Render

Deploy