# Torznab & RSS

To access the Torznab API, you should instead specify your API key as the apikey query parameter.

The Torznab API is only meant to be used by automation software, such as Sonarr or Radarr. If you want more rich data, use the JSON API instead.

The base URL for the Torznab API is https://nekobt.to/api/torznab

# Get Torznab Capabilities

GET /api?t=caps

Returns the capabilities of the Torznab API, such as supported search types and metadata formats.

# Search Torrents (RSS Feed)

GET /api?t=search

Searches for torrents. The following query parameters are supported:

Name	Type	Description
t	string	Can be `search`, `tv-search` or `movie-search`.
q?	string	The search query. If this is an empty string or null, it will return the latest torrents added.
tvdbid?	integer	The TVDB ID of the series to search for.
levels?	string	Comma-separated list of sub levels to filter for.
video_codec?	string	Comma-separated list of video codecs to filter for.
video_type?	string	Comma-separated list of video types to filter for.
audio_lang?	string	Comma-separated list of audio languages to filter for.
fansub_lang?	string	Comma-separated list of fansub languages to filter for.
sub_lang?	string	Comma-separated list of subtitle languages to filter for.
hardsub?	boolean	Set to `true` to only return torrents with hardcoded subtitles or `false` to exclude them.
otl?	boolean	Set to `true` to only return torrents with OTL subtitles or `false` to exclude them.
mtl?	boolean	Set to `true` to only return torrents with machine translated subtitles or `false` to exclude them.
group_id?	string	Group ID to filter for.
group_primary?	boolean	Set to `true` to return torrents where the group is the uploader or `false` to exclude them.
group_secondary?	boolean	Set to `true` to return torrents where the group is not the uploader or `false` to exclude them.
group_childs?	boolean	Set to `true` to include torrents from child groups or `false` to exclude them.
group_parents?	boolean	Set to `true` to include torrents from parent groups or `false` to exclude them.
uploader_id?	string	Uploader ID to filter for.
uploader_uploads?	boolean	Set to `true` to return torrents where the uploader is the uploader or `false` to exclude them.
uploader_contributions?	boolean	Set to `true` to return torrents where the uploader is not the uploader or `false` to exclude them.

# italics = default, ? = optional

The Torznab API only provides magnet links, not torrent files, to ensure torrent clients use the auto title, and not the torrent title (important for tag matching).