Prices checked 11 Nov 2026 15 providers · 9 backbones

Tools, indexers and setup

Usenet indexers and API keys explained

Short answer

An indexer API key is a personal token you get from your NZB indexer's profile page. Prowlarr, Sonarr and Radarr use it to search and fetch NZBs through the Newznab API, and you only paste it into Prowlarr once and let it sync to your apps. The key is separate from your provider login, such as your Newshosting username, so a leaked key never gives anyone access to your news server.

An indexer API key is the password your apps use to search an NZB indexer, the site that tells your downloader which articles make up a release. You copy the key from your account page on the indexer, paste it into Prowlarr, and Prowlarr hands it on to Sonarr, Radarr and Lidarr. Every search and every NZB those apps grab is counted against that key. So when the key is wrong, expired or over its daily limit, searches fail even though your Usenet provider is working perfectly.

Finding your key

Log in to the indexer and open your profile, account or API page, where you will find a long random string labelled API key. Some sites also show a separate RSS key, or a full RSS URL with the key baked in. Prowlarr needs the API key plus the site's base URL, which is usually the address you log in on. Copy the key straight from that page into Prowlarr, and never paste it into a chat or a support thread, where it stays visible to anyone reading.

Adding it to Prowlarr once

  1. In Prowlarr, go to Indexers, Add Indexer, and choose the site from the list. If it is not there, choose Generic Newznab.
  2. Fill in the base URL and paste the API key.
  3. Press Test. Prowlarr asks the site for its capabilities and shows an error if the key is rejected.
  4. Go to Settings, Apps and add Sonarr, Radarr and Lidarr, each with its own API key.
  5. From then on Prowlarr pushes the indexer and your key to every app, so you never type the key anywhere else.

Bazarr is the odd one out. It gets subtitles from its own subtitle providers and never touches your indexer key, so leave it off Prowlarr's app list. For how each app fits in, see best Usenet for Prowlarr, best Usenet for Lidarr and best Usenet for Bazarr.

What the requests look like

Nearly every indexer speaks the Newznab API. Each request is a web address containing a function name and your key, and once you know the main functions, Prowlarr's logs become far easier to follow.

FunctionExample requestSent by
caps/api?t=caps&apikey=KEYProwlarr when you press Test
search/api?t=search&q=name&apikey=KEYManual searches
tvsearch/api?t=tvsearch&q=show&season=1&apikey=KEYSonarr
movie/api?t=movie&imdbid=ID&apikey=KEYRadarr
music/api?t=music&artist=name&apikey=KEYLidarr
get/api?t=get&id=ID&apikey=KEYYour downloader, when it fetches the NZB

What the error codes mean

A failed request comes back with a Newznab error code, which Prowlarr shows in the indexer status and in its logs.

  • 100, incorrect user credentials. The key is wrong or has been regenerated, so copy it again.
  • 101, account suspended. Check your membership or get in touch with the indexer.
  • 500, request limit reached. You have used up your API calls for the day, and searches start working again when the limit resets.
  • 501, download limit reached. You hit the daily NZB grab limit for your membership tier.

Each indexer sets its own limits, and they depend on your tier. If you keep hitting 500, slow down the RSS sync in Sonarr and Radarr and stop running full-library searches over and over. Adding a second indexer with its own key spreads the load as well; how many indexers you need helps you weigh that up.

Keeping your keys safe

  • Keep keys out of Git and out of compose files you share. Put them in an env file that stays on the server.
  • Treat your Prowlarr backups as secret, since every key is inside them.
  • After a leak, or when you retire an old server, regenerate the key on the indexer site. Paste the new one into Prowlarr and the sync updates your apps for you.
  • Do not use your provider password for the indexer as well, because the two accounts protect different things.

FAQ

Is an API key the same as my provider login?
No. The API key unlocks the indexer's search, while your provider username and password unlock the news server your downloader pulls articles from.
Can two Prowlarr installs share one key?
They can, but both use up the same daily limit. Most indexers let you regenerate the key, which also cuts off any old copy you forgot about.
Why does Test pass but searches return nothing?
The key is fine, but the categories or the search type probably do not match. Check that the indexer actually supports the category Sonarr or Radarr is asking for.

Related

Read next

Tools, indexers and setup