Zyclops NewzNab Healthcheck Proxy

Zyclops proxies your NewzNab queries towards your indexer, and only returns known-healthy results for your chosen backbones or providers.

The newest untested release is ingested (sanitized and anonymized) for deeper health analysis to keep the dataset improving.
Proxied requests and downloads originate from a single WARP-VPN-protected IP to reduce the risk of multi-IP bans.
The health database is optionally searchable as a NewzNab indexer on ElfHosted private instances

Please review your indexer's rules and proceed at your own risk.

Privacy note: this builder stays client-side. The proxy still forwards your upstream API key, so treat it like any other indexer UI.

Proxy builder

Follow the guided steps to scope your proxy and drop it into clients.

Activate ElfHosted magic 🔮 ElfHosted instances get un-rate-limited proxying and built-in UsenetStreamer integration.

I use an ElfHosted Instance ❤️

When enabled the builder swaps to an faster, un-ratelimited internal URL, and unlocks the celebratory goodies.

Need one? Get an ElfHosted instance for optimal integration.

Pick your indexer Select from the curated list or paste a custom endpoint and key.

Indexer Start with the curated list; fall back to the custom URL field when needed. Custom indexer URL Only required when the dropdown above doesn’t contain your indexer. API key (from upstream indexer)

Hidden locally unless you choose to reveal it.

Runs a quick search against the target using the inputs above.

Pick backbone / provider Select Usenet backbones that should drive health testing, or override with precise provider hostnames. Zyclops falls back to backbone health when provider-level data is unavailable.

Backbone(s)

Loading catalog…

Check at least one backbone unless you plan to list provider hosts below. Provider hostname(s) Comma-separated hosts take priority over backbone selections.

Customize behaviour Control how the proxy handles unverified releases and upstream connections.

Show unknown links Enable to pass through unverified results (known-unhealthy results will still be removed) and keep upstream download URLs. Single IP mode Keeps the upstream traffic on Zyclops. Disable only if multi-IP access is acceptable.

Install into apps Pick the instructions that match your automation stack.

Show sensitive outputs Keep this off unless you need to read API-derived values on screen.

AIOStreams

Use the proxy host as the Newznab URL and paste this synthesized key into the client’s apikey field.

AIOStreams → Addons → Marketplace → Newznab:

Newznab URL:
API Path: /api (match this value)
API Key: use the Stowaway key below

Provide an upstream API key…

Usenet Streamer

Add a Newznab indexer inside UsenetStreamer pointing at the proxy host, then paste this key into the API key field.

UsenetStreamer → Settings → Direct Newznab Indexer:

Newznab URL:
API Path: /api (match this value)
API Key: use the Stowaway key below

Provide an upstream API key…

Generic

Client outputs

Pick either the direct proxy URL or the Stowaway key depending on what your client supports.

Direct proxy URL

Set this as the Newznab endpoint and keep using your upstream API key in the client’s apikey field.

Fill in the form above…

Stowaway API key

Use when the client only exposes an apikey field or refuses extra parameters on the Newznab URL. Paste this synthesized key while keeping the upstream indexer URL.

Newznab URL:
API Path: /api (match this value)
API Key: use the Stowaway key below

Provide an upstream API key…

Technical details

Privacy

The builder runs fully client-side; form inputs are not persisted or sent to Zyclops until you run a validation test.
Generated proxy URLs and Stowaway keys only encode the parameters you see; Zyclops forwards your upstream API key directly to the upstream indexer and does not store it.
No additional telemetry or analytics fire from this page. Clipboard actions copy straight from your browser to the OS clipboard.
When NZBs are ingested via the proxy for future health testing, Zyclops stores just the filename and publication date. Each sampled NZB is tested in the background against every backbone using ElfHosted-maintained NNTP providers.
Indexer searches and NZB downloads run from a single anonymous ElfHosted IP while Single IP mode stays enabled. If you disable it, searches still originate from ElfHosted, but NZB downloads fall back to your IP so the upstream indexer can see the request.

How responses behave

Only releases marked healthy for the supplied backbones/providers appear in the feed.
Each proxied query queues the newest release per pubDate for downstream health checks (ties fall back to the larger NZB).
Links point at /getnzb/{token}. Tokens expire after 60 seconds unless you raise NZB_DOWNLOAD_TOKEN_TTL_SECONDS, and downloads still succeed during the NZB_DOWNLOAD_TOKEN_GRACE_SECONDS buffer (5 minutes by default).
Single IP mode keeps upstream traffic on the ElfHosted/Zyclops IP; disable it only when your indexer tolerates multi-IP traffic.

Required parameters

target: full URL to the upstream Newznab API (scheme included).
provider_host / provider_hostname and/or backbone: comma-separated scopes that tell the proxy which NNTP paths to trust.

Optional controls

show_unknown (default false): include upstream download links for unmatched-but-healthy items.
single_ip (default true): keep it enabled unless the upstream indexer allows multi-IP hits.

Example curl

curl "https://zyclops.elfhosted.com/api/v1/newznab/proxy?target=https://upstream.example/api&provider_hostname=news.eweka.nl&t=search&cat=5000&apikey=XYZ"

Embedding via Stowaway

Append control parameters to the upstream API key (URL-encode & and =). Zyclops extracts them before forwarding.

apikey=real-secret%26target%3Dhttps%3A%2F%2Fupstream.example%2Fapi%26provider_host%3Dnews.eweka.nl

Proxy builder

Built in support 🎉

Client outputs

Direct proxy URL

Stowaway API key

Technical details