Waifu.pics API

Beginner's Pick Anime / No Auth Required Beginner HTTPS

Free to Use Varies (check documentation)

92 A+

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

Waifu.pics is a simple anime image sharing API that returns random anime images from categories like waifu, neko, shinobu, and many more. No authentication is needed, and each request returns a single random image URL. It is one of the quickest APIs for a beginner to call and get a working result.

Beginner Tip

Use GET https://api.waifu.pics/sfw/<category> for safe-for-work images. Valid categories include waifu, neko, shinobu, megumin, bully, cuddle, cry, hug, awoo, kiss, lick, pat, smug, bonk, blush, smile, wave, highfive, handhold, nom, bite, glomp, slap, kill, kick, happy, wink, poke, dance, and cringe.

Available Data

anime/manga title

episode count

airing status

synopsis

rating score

genre list

Example Response

JSON Response

{
  "id": 1,
  "title": "Attack on Titan",
  "episodes": 75,
  "status": "Finished Airing",
  "score": 8.5,
  "genres": [
    "Action",
    "Drama",
    "Fantasy"
  ],
  "synopsis": "In a world where humanity lives within enormous walled cities..."
}

Field Reference

url Direct URL to a randomly selected anime image from the requested category.

Implementation Example

Request

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://waifu.pics/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

404 Not Found The category in the URL path does not exist.

✓ Use only the exact category names listed in the waifu.pics docs. The URL path is case-sensitive.

Empty or null url field Temporary issue with image availability for that category.

✓ Retry the request; the API randomly selects from a pool, so the next call usually succeeds.

CORS blocked Waifu.pics does not support CORS, preventing browser-side requests.

✓ Use a backend server or serverless function as a proxy to fetch images server-side and relay them to the browser.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →