TorrentClaw
torrentclaw.com · Debrid · 1 record · JSON
TorrentClaw Debrid
caveatemailno cardDrequest-rate
| Free tier | Anonymous reads work and are metered: x-ratelimit-limit: 10, x-ratelimit-remaining: 9, x-ratelimit-tier: anonymous on every search response. Magnets and info hashes are not in the anonymous payload. unit requests; metered on request-count |
|---|---|
| Price | USD 0 |
| Per-object cap | not applicable: index rows |
| Retention | not applicable for a user: results are computed per request; the tracker's own stats are published at /api/v1/tracker-stats |
| Egress | no byte allowance on the API; .torrent files are proxied through cache services, and the swarm transfer is the client's free_allowance: none published |
| Identity | email A free key is required before magnets, info hashes or .torrent downloads are returned: the response itself carries '_notice: Magnet links, info hashes, and torrent downloads require a free API key. Register at https://torrentclaw.com/register'. |
| Limits |
The llms.txt says limits are per endpoint and IP-based for anonymous traffic, key-based for authenticated traffic, and that a 429 carries Retry-After. The free key raises the quota and is what unlocks magnets. |
| Binding | request-rate Ten requests per window is the hardest published number at one search per title a 1 TiB/month pull exhausts it on every batch, so the key is not optional in practice. |
| Interface | rest /api/v1/search, /api/v1/torrent/{infoHash}, /api/rss/{popular,recent,search}, /api/v1/torznab (Newznab/Torznab) and /api/stremio/manifest.json. An OpenAPI 3.1 spec sits at /api/openapi.json. |
| Tooling | curl or any HTTP client; Sonarr/Radarr take the Torznab URL with a key; an MCP server is published as an npm package. |
| Composes with | Search for a title, take the hash with a key, ask the debrid provider for a cache hit, and let the Torznab endpoint serve the automation stack. |
| Reliability | The anonymous payload is metadata only, so a client that ignores the notice will spend its quota collecting rows it cannot act on; the aggregator also depends on the upstreams it names (YTS, EZTV, Knaben, Prowlarr, Bitmagnet, Torrentio, Torrents.csv and others). |
| Notes | The only index that publishes its anonymous quota in the response headers, which makes it the honest answer to 'what is the rate limit': 10 per window, and the object itself needs a free key. The caveat is precisely that split. |
| Evidence rung | documented Three live searches were executed on 2026-10-23 and the rate headers read on each; the docs were read from llms.txt and llms-full.txt. Registering for a key would settle the free tier's real quota. |
| Checked | 2026-10-24 (live); stale on 2026-11-23 |
| Parsed numbers |
|
Evidence (3)
| date | source | what it proved |
|---|---|---|
| 2026-10-23 | torrentclaw.com/api/v1/search?q=ubuntu&limit=3 | HTTP 200 JSON with total 7 and a _notice that magnets and info hashes need a free API key |
| 2026-10-23 | torrentclaw.com/llms.txt | the endpoint list, the anonymous/free/pro tiers, and that PRO unlocks Torznab, debrid integration and custom RSS |
| 2026-10-23 | torrentclaw.com/llms-full.txt | limits are per endpoint and IP-based for anonymous traffic, 429 carries Retry-After, and the free key is enough for some endpoints while anonymous is rejected on others |
More fields (4)
{
"ratelimit_limit": 10,
"ratelimit_tier": "anonymous",
"openapi": "https://torrentclaw.com/api/openapi.json",
"torznab": "https://torrentclaw.com/api/v1/torznab"
}