You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
TRaSH-Guides/docs/Prowlarr/prowlarr-setup-limited-api.md

76 lines
3.5 KiB

# How to setup indexers with limited API
So you have access to a few (unpaid) usenet indexers with limited API calls and you still want to add them as backup for failed downloads, but you're always hitting the API limits in the first hour and can't make fully use of them.
In this Guide i will show you a trick how you can make more use of them without hitting the API limit in the first hour.
!!! info "This is mainly a usenet option but might be useful for a few trackers that have rate limits. I will use for this guide mainly usenet indexers as examples."
## Sync Profiles
This is the same you see in the Starr apps under indexers when you open the specific indexer settings.
A short description of what they do, what they mean, and when they are used.
- RSS = The so called search interval.
- Automatic search = When a item is added to the Starr apps and you do a `Add + Search`, if a "usenet" download fails it will search for a replacement, When you click on the `Search All`, `Search Monitored` or on the `magnifying icon`.
- Interactive search = When you select interactive search you get a unsorted/unfiltered list of everything your indexer(s) reports back where you can choose what you want to grab.
### Adding a Sync Profile
For this we're going to create 2 new Sync Profiles
`Settings` => `Apps`
![Settings => Apps => Sync Profiles](images/settings-apps-sync-profiles.png)
#### Automatic Search
!!! info "This one will only be used when a item is added to the Starr apps and you do a `Add + Search`.<br>If a "usenet" download fails it will search for a replacement.<br>When you click on the `Search All`, `Search Monitored` or on the `magnifying icon`."
Click on the + sign and create a new sync profile with the following options.
1. Name it `Automatic Search`
1. **Disable** Enable RSS
1. Enable Interactive Search
1. Enable Automatic Search
1. If you're using usenet ignore this, if you use public torrent trackers set this somewhere between 20-70, being they often lie about their seeders amount.
1. Click on Save
![Sync Profile Automatic Search](images/sync-profile-automatic-search.png)
#### Interactive Search
!!! info "This will be only used when you do a interactive search."
Click on the + sign and create a new sync profile with the following options.
1. Name it `Interactive Search`
1. **Disable** Enable RSS
1. Enable Interactive Search
1. **Disable** Enable Automatic Search
1. If you're using usenet ignore this, if you use public torrent trackers set this somewhere between 20-70, being they often lie about their seeders amount.
1. Click on Save
![Sync Profile Automatic Search](images/sync-profile-interactive-search.png)
### Indexers Settings
Next up configure the new Sync Profile for the indexer with the limited API.
#### Select Sync Profile
In Prowlarr, edit the indexer of your choice and under `Sync Profile` you choose one of the two newly created Sync Profiles.
For this example we're going to use `Automatic Search`.
![Select Automatic Search](images/settings-apps-sync-profiles.png)
#### Setup API Limits
In Prowlarr, edit the indexer of your choice and under `Query Limit` (_API hits_) and `Grab Limit` (_Downloads_) you set your indexers API limits, these can be found in several places depending on the indexer, this could be in your profile or when you go to a page where you can select which package you want to buy.
!!! warning "We're adding this to prevent any abuse/hammering to the indexer<br>Ignoring this can sometimes result in a (potentially lifetime) ban."
--8<-- "includes/support.md"