M
API Matrix

Waifu.im API

⭐ Beginner's Pick Anime / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)
87 Score
Grade A
Visit Official Site Compare Alternatives

Overview

Waifu.im hosts a curated archive of over 4,000 anime-style character images organized by tags like maid, uniform, wink, or ero. No API key is required to fetch images, making it one of the simplest anime image APIs to use. It is popular for Discord bots and web projects that need tagged anime images on demand.

💡

Beginner Tip

Use GET https://api.waifu.im/search/?included_tags=maid to fetch random images by tag. The is_nsfw parameter defaults to false, so all results are safe for work unless you explicitly set it to true.

Available Data

Waifu.im data via REST API
JSON-formatted response data
Freely accessible without authentication

Example Response

JSON Response 
{
  "status": "success",
  "data": {
    "result": "Data from Waifu.im",
    "description": "Get waifu pictures from an archive of over 4000 images and multiple tags",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

images Array of image objects matching the requested tags.
images[].url Direct CDN URL to the image file.
images[].tags List of tag objects describing the image content.
images[].width Pixel width of the image.
images[].height Pixel height of the image.
images[].is_nsfw Whether the image is flagged as not safe for work.

Implementation Example 

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://waifu.im/docs";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

400 Bad Request Invalid or nonexistent tag name in included_tags parameter.
✓ Fetch the valid tag list first from GET https://api.waifu.im/tags/ and use only those exact names.
404 Not Found No images match the combination of included and excluded tags.
✓ Try fewer tag filters or remove excluded_tags to broaden the search.
CORS blocked in browser Browser restricts cross-origin requests in some configurations.
✓ Waifu.im supports CORS for browser use; verify you are requesting https:// not http://.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 269ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Anime
Difficulty Beginner
Verified: 2026-04-07

Similar APIs

View All →

AnimeChan

⭐ Beginner's Pick
84

AnimeChan serves a database of 10,000+ anime quotes with character and anime title metadata.

No Auth Beginner HTTPS 37ms

AnimeFacts

⭐ Beginner's Pick
92

AnimeFacts is a simple REST API with over 100 trivia facts about popular anime series, accessible by an anime slug name.

No Auth Beginner HTTPS 39ms

AnimeNewsNetwork

⭐ Beginner's Pick
74

Anime News Network exposes its encyclopedia data as a free XML API, covering anime and manga titles, cast, staff, genres, and release information maintained by professional journalists.

No Auth Beginner HTTPS 4336ms

Catboy

⭐ Beginner's Pick
92

Catboy serves random neko (anime cat-person) images and GIFs across several mood categories with no API key required.

No Auth Beginner HTTPS 131ms

Jikan

⭐ Beginner's Pick
92

Jikan is an unofficial REST API for MyAnimeList that lets you fetch anime and manga data without OAuth setup.

No Auth Beginner HTTPS 110ms