nyaascraper

https://github.com/zrekryu/nyaascraper
Admin
nyaascraper is an asynchronous Python library for scraping torrent details and RSS feeds from...
Tokens:1,100
Snippets:16
Trust Score:5.4
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install nyaascraper

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Install the library using pip.

```bash
pip install nyaascraper
```

--------------------------------

### Get RSS Feed with Magnet Links Only

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Retrieve the RSS feed filtered to include only magnet links.

```python
feed = await client.get_feed(magnet_only=True)
```

--------------------------------

### Get Detailed Torrent Information

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Retrieve detailed information for a specific torrent using its view ID.

```python
from nyaascraper.models import TorrentInfo

result = await client.search()

# Select View-ID of the first torrent from the search results.
view_id: int = result.torrents[0].view_id

torrent_info: TorrentInfo = await client.get_torrent_info(view_id)
print(torrent_info)
```

--------------------------------

### Get RSS Feed

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Retrieve and display the RSS feed content.

```python
from nyaascraper.models import NyaaRSSFeed

feed: NyaaRSSFeed = await client.get_feed()

print("Title:", feed.title)
print("Description:", feed.description)

for torrent in feed.torrents:
    print(torrent)
```

--------------------------------

### Initialize NyaaRSSClient

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Initialize the RSS client with the desired site.

```python
from nyaascraper import NyaaRSSClient, SITE

# Work-safe site. (Default)
client = NyaaRSSClient(SITE.FUN)

# Non-work-safe site.
client = NyaaRSSClient(SITE.FAP)
```

--------------------------------

### Initialize NyaaClient

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Initialize the client with either the work-safe (FUN) or non-work-safe (FAP) site.

```python
from nyaascraper import NyaaClient, SITE

# Work-safe site. (Default)
client = NyaaClient(SITE.FUN)

# Non-work-safe site.
client = NyaaClient(SITE.FAP)
```

--------------------------------

### Change Client Site Dynamically

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Update the site property of an existing client instance.

```python
from nyaascraper import SITE

client.site = SITE.FUN
```

--------------------------------

### Search Torrents by Page

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Retrieve results from a specific page.

```python
result = await client.search(page=2)
print(result)
```

--------------------------------

### Search Torrents with Quality Filter

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Apply quality filters to search results.

```python
from nyaascraper import QualityFilter

# No Filter. (Default)
result = await client.search(quality_filter=QualityFilter.NO_FILTER)
print(result)

# Trusted only.
result = await client.search(quality_filter=QualityFilter.TRUSTED_ONLY)
print(result)

# No Remakes.
result = await client.search(quality_filter=QualityFilter.NO_REMAKES)
print(result)
```

--------------------------------

### Search Torrents with Sorting

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Sort search results by various criteria and order.

```python
from nyaascraper.enums import SortBy, SortOrder

# Sort by comments.
result = await client.search(sort_by=SortBy.COMMENTS)
print(result)

# Sort by size.
result = await client.search(sort_by=SortBy.SIZE)
print(result)

# Sort by date.
result = await client.search(sort_by=SortBy.DATE)
print(result)

# Sort by seeders.
result = await client.search(sort_by=SortBy.SEEDERS)
print(result)

# Sort by leechers.
result = await client.search(sort_by=SortBy.LEECHERS)
print(result)

# Sort by downloads.
result = await client.search(sort_by=SortBy.DOWNLOADS)
print(result)

# Sort order: Ascending.
result = await client.search(sort_order=SortOrder.ASCENDING)
print(result)

# Sort order: Descending.
result = await client.search(sort_order=SortOrder.DESCENDING)
print(result)
```

--------------------------------

### Search Torrents by Username

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Perform a search filtered by a specific username.

```python
result = await client.search(username="...")
print(result)
```

--------------------------------

### Search Torrents by Term

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Perform a search using a specific term and iterate through results.

```python
from nyaascraper.models import SearchResult

result: SearchResult = await client.search(term="...")

for torrent in result.torrents:
    print(torrent)
```

--------------------------------

### Search Torrents with Category

Source: https://github.com/zrekryu/nyaascraper/blob/main/README.md

Filter search results by specific work-safe or non-work-safe categories.

```python
from nyaascraper.enums import FunCategory, FapCategory

# Work-safe category.
result = await client.search(category=FunCategory.ANIME)
print(result)

# Work-safe subcategory search.
result = await client.search(category=FunCategory.ANIME_ENGLISH_TRANSLATED)
print(result)

# Non-work-safe category.
result = await client.search(category=FapCategory.ART)
print(result)

# Non-work-safe subcategory search.
result = await client.search(category=FapCategory.ART_MANGA)
print(result)
```
Tokens:
Raw