Skip to content

Torznab capabilities ​

Request capabilities with:

bash
curl 'http://localhost:8000/api?t=caps'

Advertised searches ​

OperationAdvertised parameters
searchq
movieq, imdbid, tmdbid
tvsearchq, season, ep, imdbid

All requests also accept t, cat, limit, offset, apikey, and extended at the HTTP layer. cat, apikey, and extended are accepted for compatibility but do not currently change search behavior.

limit defaults to 100 and must be 1–200. offset defaults to 0 and must be non-negative. Numeric IMDb IDs are normalized by adding the tt prefix.

Categories ​

IDNameMapping
2000MoviesDatabase type movie
5000TVOther non-movie, non-anime types
5070TV/AnimeDatabase type anime

XML response ​

Searches return RSS 2.0 XML. Each result can contain:

  • title, non-permalink info-hash GUID, magnet link, and optional UTC pubDate;
  • a BitTorrent enclosure with magnet URL and optional byte length;
  • Torznab attributes category, infohash, magneturl, seeders, peers, optional size, downloadvolumefactor=0, uploadvolumefactor=1, and optional provider description.

Unknown t values return a valid empty RSS feed. Database and input values are escaped by XML element serialization.

When result processing is enabled, pagination uses fixed 1000-row windows.

Violarr was created and made possible in part through generative AI tools, under human direction and review.