Torrents API

Unofficial public torrent trackers API written in Node.js.

Available routes

Route	Description	Category
/torrents/api/v1/1337x	1337x	General
/torrents/api/v1/bitsearch	Bitsearch	General
/torrents/api/v1/torlock	Torlock	General
/torrents/api/v1/knaben	Knaben	General
/torrents/api/v1/torrentgalaxy	TorrentGalaxy	General
/torrents/api/v1/zooqle	Zooqle	General
/torrents/api/v1/magnetdl	MagnetDL	General
/torrents/api/v1/thepiratebay	The Pirate Bay	General
/torrents/api/v1/glotorrents	GloTorrents	General
/torrents/api/v1/limetorrents	LimeTorrents	General
/torrents/api/v1/pirateiro	Pirateiro	General
/torrents/api/v1/nyaa	Nyaa	Anime
/torrents/api/v1/anidex	Anidex	Anime
/torrents/api/v1/animetosho	Anime Tosho	Anime
/torrents/api/v1/torrentz2	Torrentz2	General
/torrents/api/v1/gktorrent	GkTorrent	General
/torrents/api/v1/linuxtracker	LinuxTracker	Linux
/torrents/api/v1/rutor	rutor	General
/search	Search the DB	Database

Usage

requires Node version >=10.0.0

Api doesn't show any dead torrents in search result.

Payload examples:

*routes:
method: POST
Content-Type: application/json

{   "page": 1 // this field is optional (page data type is number)
    "search": "search query"
}

On Knaben's few search results you'll see https://knaben.eu/live/dl/rutracker/? this types of links well fret NOT just add them to your client and it'll automatically starts downloading like other magnet urls.

Pagination Supported Routes

• bitsearch
• knaben
• limetorrents
• nyaa
• 1337x
• rutor

Requirements

Navigate to the cloned directory

Install dependencies: npm install

Copy the .env.sample to .env using this command cp .env.sample .env file inside the directory and fill in all the details.

Added MongoDB support. Make sure to fill MONGODB_URI. NO data duplications. If a user search for something that is already present in db it won't be saved into db.

1337x, Anidex, MagnetDL and Pirateiro has protection enabled. To bypass that need cookies from their sites. So, visit these sites and open network tab search for something and get the Cookie value and save them in .env file.

TorrentGalaxy shows captcha when you search for something. After completing the captcha open network tab and search for something and grab the Cookie value also make sure Cookie value includes fencekey

Start server

To run the server on your local machine, execute the following command: npm run dev
On the server, use: npm run start You also have the option to run it using pm2. If you don't have pm2 installed, install it using the following command: npm i pm2 -g. Ensure pm2 automatically starts up when the server restarts. To launch the API, use: npm run server:up To refresh the API, use: npm run server:restart To shut down the API, use: npm run server:down

It's recommend to running the API with PM2. It allows you to keep your Node. js applications running continuously: PM2 can automatically restart your application if it crashes, and it can also automatically reload your application when you update your code

Tech Stack

The Torrents API is built using the following technologies:

• Node.js
• Express.js
• Axios
• Cheerio
• dotenv
• Mongoose
• Winston

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Show your support by starring ⭐️ this project!