https://github.com/netfloex/torrentapi
https://github.com/netfloex/torrentapi
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/netfloex/torrentapi
- Owner: Netfloex
- Created: 2023-05-15T14:44:20.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-16T00:10:31.000Z (5 months ago)
- Last Synced: 2025-02-16T23:24:39.961Z (3 months ago)
- Language: Rust
- Size: 402 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Torrent Api
Torrent search api wrapper and parser for popular torrent sites.
### Packages
- `api-server`: The http api for querying the search package
- `torrent-search-client`: A rust crate for searching on popular torrent sites
### Usage
#### Docker Compose
```yaml
version: "3"
services:
torrentapi:
image: netfloex/torrent-api
container_name: torrent-api
restart: unless-stopped
ports:
- 8000:8000
volumes:
- ./cache:/http-cacache
```
#### Docker Run
```sh
docker run -it -p 8000:8000 -v $PWD/cache:/http-cacache netfloex/torrent-api
```
### Usage
#### Search for torrents
```sh
curl localhost:8000/search?q=
```
#### Search for movie torrents
```sh
curl localhost:8000/search?imdb=
```
### Parameters
#### Torrent search
| param | description | Required |
| -------- | --------------------------------------------------------- | ------------------ |
| query | Query to search for torrents | :heavy_check_mark: |
| category | `All`, `Applications`, `Audio`, `Games`, `Other`, `Video` | :x: |
| sort | `Added`, `Size`, `Seeders`, `Leechers` | :x: |
| order | `Asc`, `Desc` | :x: |
| limit | Integer | :x: |
#### Movie search
| param | description | Required |
| ------- | ------------------------------------------------------------------------- | ------------------ |
| imdb | IMDB id | :heavy_check_mark: |
| title | Title of the movie | :x: |
| sort | `Added`, `Size`, `Seeders`, `Leechers` | :x: |
| order | `Asc`, `Desc` | :x: |
| limit | `Integer`, limit the results to ... length | :x: |
| quality | `480p`,`720p`,`1080p`,`2160p` | :x: |
| codec | `x264`, `x265` | :x: |
| source | `Cam`, `Telesync`, `Telecine`, `Dvd`, `Hdtv`, `Hdrip`, `WebRip`, `BluRay` | :x: |
### Current Providers
- BitSearch (bitsearch.to)
- The Pirate Bay (apibay.org)
- 1337x (1337x.to)
- Yts (yts.mx)