ONLY FOR PERSONAL USE!!! For commercial use write me in telegram or email.

Introduction

For authorizing your application, you are REQUIRED to get the token from here by creating a new application. Public token required to be passed in X-Application header.

All requests are working with JSON, all body also in JSON.

Users authorization

To get token, you can use /profile/login method. Token is valid for 2 weeks. Refresh it every 2-3 days using /profile/token method.

For authorization pass your token in the Authorization header with the Bearer scheme (for example, Authorization: Bearer this.is.token.you.get).

Language

If you want to get content in different languages, pass Lang header with needed language. Accepted values for now:

• ru - Russian
• en - English
• jp - Japanese (would be added soon)

Otherwise, server would look on Accept-Language header.

Captcha

Website uses HCaptcha, so if you get 420 error (see bruteforce abuse warning), your app should show captcha to user and repeat the request with the same data and captcha response passed in the body.

SITE_KEY="b1847961-208e-4a90-9671-1e6bba9e0b36" (used in initializing HCaptcha)

Response content types

The default response content type is json, but (if you really want), you can specify it using Vary header. Supported values for Vary headers: json, json5 and xml.

Also pass Accept header with each request, where include image/avif and image/webp (through comma) if client supports them (otherwise, they would be replaced by JPEG images worse quality).

Example (Python):

import requests
requests.get('https://api.yani.tv/anime', params={'limit': 1, 'offset': 1}, headers={'X-Application': 'your_token', 'Accept': 'image/avif,image/webp'})
# OR
import asyncio, yummyanime # https://github.com/IM1corp/YummyAPI
async def main(url):
    api = yummyanime.YummyApi('your_token')
    print((await api.anime.get(url)).response)
asyncio.run(main(1))

Raw swagger file

If you need RAW swagger JSON file, you can download it from here