This endpoint allows you to access and retrieve information about your favorite waifus. To access the /waifu endpoint, you will need to provide the proper authentication using the Authorization header.

Endpoint Details

The /waifu endpoint allows you to retrieve information about a specific waifu.

  • URL: /waifu
  • Method: GET
  • Content Type: application/json


To make requests to the /waifu endpoint, you must include an Authorization header in your API calls. This header should contain a valid access token.

Example Authorization Header

Authorization: YOUR_ACCESS_TOKEN

Replace YOUR_ACCESS_TOKEN with the actual token provided to you.

Request Headers

The request to the /waifu endpoint should be a JSON object with the following headers:

AuthorizationstringThe unique identifier of the user sending the request.True

Example Request

Here's example of how to make a request to the /waifu endpoint.

import axios from "axios";
Replace "YOUR_ACCESS_TOKEN" with the token you got from the Kohai Bot and the endpoint.
const url = "https://waifu.it/api/waifu";
const data = async () => {
  try {
    const { data } = await axios.get(url, { headers: {
      Authorization: "YOUR_ACCESS_TOKEN",
    } });
    return data;
  } catch (err) {
    throw new Error(err.message);

Remember to replace YOUR_ACCESS_TOKEN with your actual access token.


The server will respond with an appropriate message based on the input provided. A successfully API request will respond with a JSON object containing the following information:

  • _id: The unique identifier of the waifu.
  • names: The names of the waifu.
  • from: The anime from where the waifu belongs to.
  • statistics: Her statistics from the users.
  • images: The array of URLs to an image of the waifu.
  • status: Response status

Content Type: application/json

  "status": 200,
  "_id": 48,
  "images": [
  "names": {
    "en": "Kanade Tachibana",
    "jp": "立華 かなで",
    "alt": "Tenshi"
  "from": {
    "name": "Angel Beats!",
    "type": "Anime"
  "statistics": {
    "fav": 205,
    "love": 160,
    "hate": 20,
    "upvote": 70,
    "downvote": 8

This documentation should help you use axios (opens in a new tab) for Node.js and requests (opens in a new tab) for Python to interact with the /waifu endpoint. That's it! You are now ready to use the /waifu endpoint to retrieve information about your favorite waifus. Happy coding!