Security NoticeLIVE

Website is experiencing a sustained, high-volume attack for weeks now. To protect service availability, we are automatically blocking IP addresses that generate unusually high requests. This automated protection may occasionally block legitimate users by mistake. Tor V3 onion domain is active — use it to bypass any IP blocks.

Clearnet: OnlineTor: Online — .onion availableAuto-IP-Block: Active
TorrentX
Register
Back to home

API Documentation

REST API for interacting with TorrentX torrents. All responses are JSON unless noted.

GET/api/torrents

List all torrents with pagination

Query Parameters

page(number)Page number (default: 1)
limit(number)Results per page (default: 50)
category(string)Filter by category
GET/api/search

Search torrents by title or description

Query Parameters

q(string)Search query
cat(string)Category filter
sort(string)Sort field (title, size, seeds, leeches)
order(string)Sort order (asc, desc)
POST/api/torrents

Create a new torrent (auth required)

Request Body

{ title, category, size, magnetLink, description?, source?, subcategory? }
GET/api/comments

Get comments for a torrent

Query Parameters

torrentId(string)Torrent ID
POST/api/comments

Add a comment to a torrent

Request Body

{ torrentId, author, content }
POST/api/comments/vote

Vote on a comment

Request Body

{ commentId, direction: "up" | "down" }
GET/api/bookmarks

List user bookmarks (auth required)

POST/api/bookmarks

Toggle bookmark on a torrent (auth required)

Request Body

{ torrentId }
GET/api/notifications

List user notifications (auth required)

POST/api/notifications

Mark a notification as read (auth required)

Request Body

{ notificationId }
GET/rss

RSS feed of latest 50 torrents