Waifu API

The Waifu Images API provides a collection of waifu images based on specified tags and height requirements.

Base URL

"https://openapi-idk8.onrender.com"

Endpoints

• GET /waifu: Fetch waifu images based on specified tags, height requirements, and NSFW settings.
• GET /waifu/tags: Retrieve the list of available NSFW and regular tags.

Query Parameters

• included_tags (optional): A comma-separated list of tags to include in the search. Example: `waifu,maid`.
• height (optional): Height requirement for the images. Default is `>=2000`.
• is_nsfw (optional): Boolean flag to include NSFW content. Default is `false`.

List of Available Tags

Regular Tags

• waifu
• maid
• marin-kitagawa
• mori-calliope
• raiden-shogun
• oppai
• selfies
• uniform
• kamisato-ayaka

NSFW Tags

• ero
• ass
• hentai
• milf
• oral
• paizuri
• ecchi

Sample Request | Random Images

GET "https://openapi-idk8.onrender.com/waifu"

Sample Request | Regular Tag

GET "https://openapi-idk8.onrender.com/waifu?included_tags=maid"

Sample Response

{
  "images": [
    {
      "signature": "33cc3bed0b8401b6",
      "extension": ".jpeg",
      "image_id": 3109,
      "favorites": 5,
      "dominant_color": "#dbd1d4",
      "source": "https://reddit.com/lwzv28/",
      "artist": null,
      "uploaded_at": "2021-11-02T12:16:19.048684+01:00",
      "liked_at": null,
      "is_nsfw": false,
      "width": 1749,
      "height": 3500,
      "byte_size": 403919,
      "url": "https://cdn.waifu.im/3109.jpeg",
      "preview_url": "https://www.waifu.im/preview/3109/",
      "tags": [
        {
          "tag_id": 12,
          "name": "waifu",
          "description": "A female anime/manga character.",
          "is_nsfw": false
        }
      ]
    }
  ],
  ...
}

Sample Request | NSFW Tag

GET "https://openapi-idk8.onrender.com/waifu?included_tags=oral"

Sample Response

{
  "images": [
    {
      "signature": "cce1cfa465321a46",
      "extension": ".jpeg",
      "image_id": 1188,
      "favorites": 1,
      "dominant_color": "#81848d",
      "source": "https://reddit.com/hczusb/",
      "artist": null,
      "uploaded_at": "2021-11-02T12:16:19.048684+01:00",
      "liked_at": null,
      "is_nsfw": true,
      "width": 1559,
      "height": 2176,
      "byte_size": 291408,
      "url": "https://cdn.waifu.im/1188.jpeg",
      "preview_url": "https://www.waifu.im/preview/1188/",
      "tags": [
        {
          "tag_id": 2,
          "name": "ecchi",
          "description": "Slightly explicit sexual content. Show full to partial nudity. Doesn't show any genital.",
          "is_nsfw": true
        },
        {
          "tag_id": 10,
          "name": "selfies",
          "description": "A photo-like image of a waifu.",
          "is_nsfw": false
        },
        {
          "tag_id": 3,
          "name": "ero",
          "description": "Any kind of erotic content, basically any nsfw image.",
          "is_nsfw": true
        },
        {
          "tag_id": 12,
          "name": "waifu",
          "description": "A female anime/manga character.",
          "is_nsfw": false
        }
      ]
    }
  ],
  ...
}

Sample Request | Height

GET "https://openapi-idk8.onrender.com/waifu?included_tags=maid&height=>=2000"

Sample Request | List of Available Tags

GET "https://openapi-idk8.onrender.com/waifu/tags"

Sample Response

{
  "nsfw_tags": [
    "ero",
    "ass",
    "hentai",
    "milf",
    "oral",
    "paizuri",
    "ecchi"
  ],
  "regular_tags": [
    "waifu",
    "maid",
    "marin-kitagawa",
    "mori-calliope",
    "raiden-shogun",
    "oppai",
    "selfies",
    "uniform",
    "kamisato-ayaka"
  ]
}

{
  "error": "Failed to fetch waifu images"
}