Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/Ryuk-me/Torrent-Api-py

An Unofficial API for 1337x, Piratebay, Nyaasi, Torlock, Torrent Galaxy, Zooqle, Kickass, Bitsearch, MagnetDL,Libgen, YTS, Limetorrent, TorrentFunk, Glodls, TorrentProject and YourBittorrent
https://github.com/Ryuk-me/Torrent-Api-py
1337x-api bitsearch-api glodls-api kickass-api libgen-api limetorrents magnetdl-api nyaasi-api piratebay-api scraping torlock-api torrent-api torrent-galaxy torrentfunk torrentproject torrents yts-api zooqle-api
Last synced: about 1 month ago
JSON representation
An Unofficial API for 1337x, Piratebay, Nyaasi, Torlock, Torrent Galaxy, Zooqle, Kickass, Bitsearch, MagnetDL,Libgen, YTS, Limetorrent, TorrentFunk, Glodls, TorrentProject and YourBittorrent
Host: GitHub
URL: https://github.com/Ryuk-me/Torrent-Api-py
Owner: Ryuk-me
License: mit
Created: 2022-01-27T21:03:45.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2024-07-26T10:02:08.000Z (5 months ago)
Last Synced: 2024-08-01T19:47:29.617Z (4 months ago)
Topics: 1337x-api, bitsearch-api, glodls-api, kickass-api, libgen-api, limetorrents, magnetdl-api, nyaasi-api, piratebay-api, scraping, torlock-api, torrent-api, torrent-galaxy, torrentfunk, torrentproject, torrents, yts-api, zooqle-api
Language: Python
Homepage: https://torrent-api-py-nx0x.onrender.com/docs
Size: 135 KB
Stars: 298
Watchers: 6
Forks: 233
Open Issues: 9
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project

README

        
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

```sh

# 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](https://github.com/Ryuk-me/Torrent-Api-py/blob/main/helper/is_site_available.py#L39)



```json

{

        "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`](https://torrent-api-py-nx0x.onrender.com/api/v1/sites)






Search



> [`api/v1/search`](https://torrent-api-py-nx0x.onrender.com/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](https://torrent-api-py-nx0x.onrender.com/api/v1/all/search?query=avengers)

> [api/v1/all/search?query=avengers&limit=5](https://torrent-api-py-nx0x.onrender.com/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](https://torrent-api-py-nx0x.onrender.com/api/v1/all/trending)

> [api/v1/all/trending?limit=2](https://torrent-api-py-nx0x.onrender.com/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](https://torrent-api-py-nx0x.onrender.com/api/v1/all/recent)

> [api/v1/all/recent?limit=2](https://torrent-api-py-nx0x.onrender.com/api/v1/all/recent)



---

## Want to Try api ?

> [api/v1/search?site=1337x&query=eternals](https://torrent-api-py-nx0x.onrender.com/api/v1/search?site=1337x&query=eternals)

 See response



```json

{

  "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"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/ryukmee)

---

## DEPLOY







[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)