v1.3 - Torznab Release Tags

Status:

Draft torznab

Date:

November 2017

Attributions:

• Taloth

Summary

Torrent releases are often classified with specific tags such as internal or freeleech. These tags are indexer specific and should be queryable on the api. This revision proposes formalizing an optional tag query parameter and related extended attribute allow the client to further filter results.

Release Tags

Add a tags element to the Capabilities containing a list of tag element with a name and description for each tag used in the indexer.

Example

<?xml version="1.0" encoding="UTF-8"?>
<caps>
   ...

   <tags>
      <tag name="anonymous" description="Uploader is anonymous" />
      <tag name="trusted" description="Uploader has high reputation" />
      <tag name="internal" description="Uploader is an internal release group" />
   </tags>
</caps>

Clients should not assume the tags element to be available in the capabilities.

Clients may use the description to visualize the available tags to the user.

Add the following extended attributes:

name	type	default	description
tag	string		Individual tag. May occur multiple times.

Todo

Incomplete

Known tags

The following table is an inexhaustive list of the available tags. Services shall not designate an alternative meaning to these tags.

name	description
anonymous	Uploaded by an anonymous user.
trusted	Uploader is trusted by the site.
internal	Uploaded by a release group internal to the site.

Todo

Consider other tags to be added to this list.

Example

The release in the api result will have the following attributes:

<torznab:attr name="tag" value="internal" />
<torznab:attr name="tag" value="freeleech" />

Adoption