TorrentClaw
- Free allowance
- Anonymous reads work and are metered: x-ratelimit-limit: 10, x-ratelimit-remaining: 9, x-ratelimit-tier: anonymous on every search response.
- Verdict
- caveatusable, with a named limit or an unprobed read path
- Cost
- free tier
- Identity
- emailno card, no phone
- Binding limit
- request-rate10 per window for the anonymous tier, returned in-band as x-ratelimit-limit: 10 with a reset stamp 42 to 60 s ahead of the request
- Evidence
- documented3 sources; a first-party page was read and the sentence quoted
- Freshness
- stale on 2026-11-23checked 2026-10-23 (live); stale on 2026-11-23
| 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 |
| 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. |
| 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'. |
| Egress | no byte allowance on the API; .torrent files are proxied through cache services, and the swarm transfer is a user's free allowance: none published |
| 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 |
| 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 note | 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. |
| 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 |