# TorrentClaw

> torrentclaw.com | Debrid; 1 record: free tier, limits, identity cost and evidence.

HTML https://fshy.ajam.dev/p/torrentclaw/ | JSON https://fshy.ajam.dev/api/v1/entity/torrentclaw.json | how to read a record: https://fshy.ajam.dev/llms-full.txt

## TorrentClaw

- `debrid/torrentclaw` | qualifies-with-caveat | evidence documented | binding request-rate | category torrent aggregator (JSON API, Torznab, RSS, Stremio addon) | tier free
- needs card no, phone no, ID no, institution no | verified 2026-10-23T01:52:28.000Z (live) | stale on 2026-11-23
- url https://torrentclaw.com/
- price USD 0
- 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 | read on: 2026-10-23 | source: [1]
- per-object cap: not applicable: index rows | source: [2]
- retention: not applicable for a user: results are computed per request; the tracker's own stats are published at /api/v1/tracker-stats | source: [3]
- egress: no byte allowance on the API; .torrent files are proxied through cache services, and the swarm transfer is a user's | metered: no | free allowance: none published | source: [2]
- identity: email | detail: 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'.
- interface: rest
- limits:
  - request-rate (binding): 10 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 probe:torrentclaw.com/api/v1/search
- limits note: 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 note: 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 detail: /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.
- endpoint: https://torrentclaw.com/api/v1/search?q=ubuntu&limit=3
- 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: 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.
- extras:
  - ratelimit_limit: 10
  - ratelimit_tier: anonymous
  - openapi: https://torrentclaw.com/api/openapi.json
  - torznab: https://torrentclaw.com/api/v1/torznab
- evidence:
  - [1] 2026-10-23: HTTP 200 JSON with total 7 and a _notice that magnets and info hashes need a free API key
  - [3] 2026-10-23: the endpoint list, the anonymous/free/pro tiers, and that PRO unlocks Torznab, debrid integration and custom RSS
  - [4] 2026-10-23: 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
- sources:
  - [1] https://torrentclaw.com/api/v1/search?q=ubuntu&limit=3
  - [2] https://torrentclaw.com/
  - [3] https://torrentclaw.com/llms.txt
  - [4] https://torrentclaw.com/llms-full.txt