Skip to content

An API for fetching torrents from Nyaa and Sukebei (closed source).

Notifications You must be signed in to change notification settings

Vivek-Kolhe/Nyaa-API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 

Repository files navigation

Nyaa API

Nyaa API is an Unofficial Nyaa.si API. It just scrapes the website to satisfy the need for an API.
The API is closed source for now. I might make it open source in the near future. Documentation.

Usage

The API is available at: https://nyaaapi.onrender.com/

Search

  • Nyaa Endpoint: https://nyaaapi.onrender.com/nyaa
  • Sukebei Endpoint: https://nyaaapi.onrender.com/sukebei

Examples

  • https://nyaaapi.onrender.com/nyaa?q={query}&category={torrent_category}
  • https://nyaaapi.onrender.com/sukebei?q={query}&category={torrent_category}

Note: These endpoints also take optional query parameters. For more info, visit here.

User search

  • Nyaa Endpoint: https://nyaaapi.onrender.com/nyaa/user/{user_name}
  • Sukebei Endpoint: https://nyaaapi.onrender.com/sukebei/user/{user_name}

Examples

  • https://nyaaapi.onrender.com/nyaa/user/{user_name}?q={query}&category={torrent_category}
  • https://nyaaapi.onrender.com/sukebei/user/{user_name}?q={query}&category={torrent_category}

Note: These endpoints also take optional query parameters. For more info, visit here.

Search using torrent ID

  • Nyaa Endpoint: https://nyaaapi.onrender.com/nyaa/id/{torrent_id}
  • Sukebei Endpoint: https://nyaaapi.onrender.com/sukebei/id/{torrent_id}

Examples

  • https://nyaaapi.onrender.com/nyaa/id/{torrent_id}
  • https://nyaaapi.onrender.com/sukebei/id/{torrent_id}

Note: For more info, visit here.

Allowed Param Values

  • Nyaa

    Category Sub-Category
    anime amv, eng, non-eng, raw
    manga eng, non-eng, raw
    audio lossy, lossless
    pictures photos, graphics
    live_action promo, eng, non-eng, raw
    software application, games
  • Sukebei

    Category Sub-Category
    art anime, doujinshi, games, manga, pictures
    real photos, videos
  • Sorting

    sort: id, leechers, seeders, size, downloads

  • Ordering

    order: asc, desc

Note: sort and order params are common for both endpoints.

Disclaimer

I do not host any of the torrents fetched by the API. The API is just meant to scrape the website and return the results. I do not promote piracy, if you guys can afford legal methods, then use them and support the industry :).
Use it at your own risk!