Two endpoints:
/newznab for usenet and /torznab for torrents. Add
whichever you need (or both). Torznab requires the operator to enable it, see
Torznab requirements.What you get
- A standard Newznab endpoint backed by Torrin’s usenet search — your own indexers (BYOK) and the built-in indexer both flow through it.
- A standard Torznab endpoint backed by Torrin’s torrent search — results are returned as magnets, and anything already in Torrin’s cache is tagged so your *arr app can prefer instant content.
- Works anywhere “Generic Newznab” / “Generic Torznab” is supported (Prowlarr, NZBHydra2, Jackett, the *arr apps, AIOStreams).
Newznab (usenet)
Requirements
- A plan with usenet search, and at least one indexer available to your account (a BYOK Newznab indexer or the built-in one enabled) — the same gate as searching inside Torrin.
- Your Torrin API key.
Add Torrin in Prowlarr
Settings → Indexers → Add Indexer → Generic Newznab, then set:
Hit Test — it should go green. The same URL + key work in NZBHydra2 (add a
“Newznab” indexer), Jackett, or directly in any *arr app’s indexer settings.
Torznab (torrents)
Requirements
- The operator must enable it by setting
COMET_URL(andCOMET_SEARCH_KEY) on the API service, see Configuration. Until then the endpoint returns “not available”. - Any paid plan, and your Torrin API key.
Add Torrin in Prowlarr
Settings → Indexers → Add Indexer → Generic Torznab, then set:
Hit Test — it should go green. Results carry seeders, size, and infohash, and
cached releases get a
[CACHED] tag on the title plus higher ranking. To
auto-prefer them, add a Custom Format in Sonarr/Radarr matching CACHED and give
it a positive score.
How it works
1
The app searches Torrin
Prowlarr/*arr calls
/newznab/api or /torznab/api with t=search|tvsearch|movie
and your API key. Supported params: q, imdbid, season, ep.2
Torrin runs the search
For usenet, Torrin searches your configured indexers (BYOK + built-in). For
torrents, it runs its torrent search and flags anything already in the cache.
3
Torrin returns results
Usenet results come back as a Newznab RSS feed. Torrent results come back as a
Torznab feed of magnets, cached-first, with
[CACHED] tags on releases
already in Torrin.4
The app grabs a result
On a usenet grab the link resolves to the real
.nzb through Torrin; a torrent
grab hands the magnet to the download client. Either way it works with any
client, including Torrin itself.