👋Getting Started

The API can be used with any programming language, some examples can be found here: https://github.com/Kawaii-API/Examples

API Token

To get a token you must first login to your dashboard where you will find your personal api token.

If you don't want to log in or you think the stat functions are necessary you can use the token anonymous instead of your token so you can still use the api but you will miss some functions.

If you want to know more about the token (how, why and where) you can check here:

API Request

For testing you can make the api requests also via the browser.

Basic Request

GET https://kawaii.red/api/MAIN/SUB?token=TOKEN&type=TYPE&filter=FILTER

The structure of the request system.

Path Parameters

{
   "response": "Requested content"
}

Example Request

GET https://kawaii.red/api/gif/hug?token=anonymous

You can open this link in your browser.

Path Parameters

{
   "response":"https://api.kawaii.red/gif/hug/hug1.gif"
}

NEW! API Request

The new way is completely header-based, so please use an extra tool for testing.

Basic Request

GET https://kawaii.red/api/main/sub

Path Parameters

Headers

{
   "response": "Requested content"
}

Example Request

GET https://kawaii.red/api/gif/hug

Path Parameters

Headers

{
   "response":"https://api.kawaii.red/gif/hug/hug1.gif"
}

The api always returns a 200: OK message even for wrong requests, however it gives an error message out with the exact reason should something be wrong.

Error layout:

{
   "error": f"Error reason! For more information go to https://kawaii.red/docs/"
}

Here you will find a detailed explanation for all cases and with more detailed explanations of how it works:

API Endpoints

Currently not yet ready. I'm sorry.

Currently not yet ready. I'm sorry.

Through this endpoint you can query many different anime GIFs.

Here you can query your stats or your complete database entry.

Last updated