Skip to content

Quick Start

For quick, single interactions with Nyaa.si you can use the top-level convenience functions:

  • pynyaa.get
  • pynyaa.search

These helpers create a temporary pynyaa.Nyaa client under the hood for one-off requests and then close it automatically.

import pynyaa

release = pynyaa.get("https://nyaa.si/view/1693817")  # Full URL
release = pynyaa.get(1693817)  # Only the ID also works

print(release.title)
#> [LYS1TH3A] Fate/stay night Heaven's Feel I. Presage Flower (2017) (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]
print(release.submitter)
#> pog42
print(release.torrent.infohash)
#> 6fdc0395a7fdde6ce3fb7f144b31f3cabdcbf537

releases = pynyaa.search("LYS1TH3A")

for release in releases:
    print(release)
    #> [LYS1TH3A] Fate/Zero Season 1 (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]
    #> [LYS1TH3A] Tamako Market Season 1 (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]
    #> [LYS1TH3A] Tamako Love Story (2014) (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]

Advanced

If you're doing anything more than quick experiments or one-off scripts, it's best to use the Nyaa/AsyncNyaa client directly. They give you far more flexibility and control over the requests along with improved performance.

Note

For more details, see the HTTPX documentation on clients.

Using the same example as above but with the Nyaa client: 

from pynyaa import Nyaa

with Nyaa() as nyaa:
    release = nyaa.get("https://nyaa.si/view/1693817")

    print(release.title)
    #> [LYS1TH3A] Fate/stay night Heaven's Feel I. Presage Flower (2017) (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]

    releases = nyaa.search("LYS1TH3A")

    for release in torrents:
        print(release)
        #> [LYS1TH3A] Fate/Zero Season 1 (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]
        #> [LYS1TH3A] Tamako Market Season 1 (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]
        #> [LYS1TH3A] Tamako Love Story (2014) (BD 1080p HEVC x265 10-bit Opus) [Dual-Audio]

You can also pass your own instance of an httpx.Client to the Nyaa client. This gives you complete control over the requests. For example, we can use this to quickly implement aggressive caching with hishel:

from hishel import CacheClient, Controller, InMemoryStorage
from pynyaa import Nyaa

storage = InMemoryStorage(capacity=256)
controller = Controller(force_cache=True)
client = CacheClient(storage=storage, controller=controller)

with Nyaa(client=client) as nyaa:
    release = nyaa.get("https://nyaa.si/view/1693817")  # First request
    release = nyaa.get("https://nyaa.si/view/1693817")  # Returns the cached result