https://github.com/joybiswas007/torrents-api

Unofficial public torrent trackers API written in Node.js.
https://github.com/joybiswas007/torrents-api

api bitsearch knaben node nodejs public-trackers rest-api search search-engine torlock torrent torrents

Last synced: about 1 month ago
JSON representation

Unofficial public torrent trackers API written in Node.js.

• Host: GitHub
• URL: https://github.com/joybiswas007/torrents-api
• Owner: joybiswas007
• License: mit
• Created: 2023-09-22T06:07:11.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-13T02:38:34.000Z (7 months ago)
• Last Synced: 2024-06-13T06:45:31.389Z (7 months ago)
• Topics: api, bitsearch, knaben, node, nodejs, public-trackers, rest-api, search, search-engine, torlock, torrent, torrents
• Language: JavaScript
• Homepage:
• Size: 485 KB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## 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 [⭐️](https://github.com/joybiswas007/torrents-api/stargazers) this project!