Skip to main content

Nyaax - Nyaa API written in Python

Installation

Nyaax is available on Pypi so you can install it using pip

pip install nyaax

API

Six methods are available to use:

  • get_view
  • get_description
  • get_single_torrent
  • get_comments
  • get_multiple_torrents
  • get_multiple_torrents_rss

(Working on get_file_tree)

To use them, import the module 'extractors':

import requests
from nyaax import extractors as ex

rs = requests.get("https://nyaa.si/?f=0&c=0_0&q=Initial+D")
torrents = ex.get_multiple_torrents(rs)

# torrents -> [Torrent(seeders=10, code=2, ...), Torrent(info_hash=..., ...), ...]

Each method is responsible for extracting data from a particular page or a portion of it. Below is a brief description of the methods currently available and from which URLs they extract the data.

[https://nyaa.si/view/...]

  • get_view -> View
  • get_description -> str
  • get_single_torrent -> Torrent
  • get_comments -> list[Comment]

[https://nyaa.si/?q=...]

  • get_multiple_torrents -> list[Torrent]

[https://nyaa.si/?page=rss&q=...]

  • get_multiple_torrents_rss -> list[Torrent]

Below is a description of the objects returned by the 'extractors' module functions:

Torrent:

  • size: int
  • date: datetime
  • seeders: int
  • leechers: int
  • completed_downloads: int
  • category: str
  • subcategory: str
  • title: str
  • code: int
  • magnet_link: str
  • comments: int
  • torrent_type: str | None
  • information: str | None
  • info_hash: str | None
  • submitter: User | None

User:

  • name: str
  • trusted: bool

View:

  • torrent: Torrent
  • description: str
  • comments: list[Comment]

Comment:

  • user: User
  • date: str
  • text: str
  • avatar: str | None

Metadata

Release files for nyaax 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nyaax 0.1.2
File Size Uploaded
nyaax-0.1.2.tar.gz 5.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nyaax 0.1.2
File Interpreter ABI Platform
nyaax-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 11.7 kB

Release files / nyaax-0.1.2.tar.gz

Download URL nyaax-0.1.2.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
c109e4040046d3d58b09a7c9728c445d9b97ceebe5946ce8fc2e51dc4bec3716
BLAKE2b-256 checksum
How to use checksums
6d2ce8a9c10eca19078eab9dc3548d65a9443338a3e474c6f5496c9901a805c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Dec 10, 2025.

Transparency log

Release files / nyaax-0.1.2-py3-none-any.whl

Download URL nyaax-0.1.2-py3-none-any.whl
Size 6.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a3cae19fc97b7562262a59b35f988f02366eb1960276695b32c111077ddec741
BLAKE2b-256 checksum
How to use checksums
0c873ab71551782c6e01edf5c891c38d84f6504782bce0768634195d5d2dc36b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Dec 10, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page