/nyaasi-API

Non-Official NyaaSi API

Primary LanguagePythonMIT LicenseMIT

nyaa.si API

Unofficial nyaa.si HTTP API based on scrapping NyaaPy Python library.

Hosting

  • Initialize virtualenv (optional).
$ virtualenv venv
  • Install requirements.
$ pip install -r requirements
  • Run server.
$ gunicorn main:app --log-file -

One-click deploy to Heroku

Deploy to Heroku

Usage

  • All queries must be a GET requests.

Example request with cURL

$ curl "http://localhost:5000/?q=pokemon&category=2&subcategory=3"

Parameters

Parameter Value
q query string (required)
category category number (optional, default 0)
subcategory subcategory number (optional, default 0)
page page number (optional, default 1, range: 0-1000)
sort sort results(optional, deafault "id")
order order results(optional, default "desc",options: "desc" or "asc" )

Categories

Number Category
0 All categories and subcategories
1 Anime
2 Audio
3 Literature
4 Live Action
5 Pictures
6 Software

Subcategories

Number (Cat.Sub) Subcategory
1.1 Anime Music Video
1.2 English-translated
1.3 Non-English-translated
1.4 Raw
2.1 Lossless
2.2 Lossy
3.1 English-translated
3.2 Non-English-translated
3.3 Raw
4.1 English-translated
4.2 Idol/Promotional Video
4.3 Non-English-translated
4.4 Raw
5.1 Graphics
5.2 Photos
6.1 Applications
6.2 Games

Sort

Field Sort
comments Sort by Comments
size Sort by Size
id Sort by Date
seeders Sort by Seeders
leechers Sort by Leechers
downloads Sort by Downloads