Placewaifu

An anime girl placeholder service. Not the one you need, but the one you deserve.

Ever wanted to use some placeholder images for your website and came across... that?

It's convenient I guess, but nobody wants to look at this. Instead you want to look at cute anime girls... trust me.

Usage

All you have to do is add an img tag like this and you'll get a random image at the right size.

<img src="https://placewaifu.com/image/200">

View all images here

Endpoints

There are multiple endpoints you can use to change the target image sizes.

Endpoint	Description	Response Type
`/image`	Random image of any dimension	`image/svg+xml`
`/image/:size`	Random square image of length `:size`	`image/svg+xml`
`/image/:width/:height`	Random image of `:width` x `:height` dimensions	`image/svg+xml`
`/images`	A full list of all base64 encoded images	`application/json`

Example /images response

[
  {
    "name": "aoba",
    "source": "https://myanimelist.net/anime/31953/New_Game/",
    "height": 1000,
    "width": 750,
    "format": "png",
    "data": "--base64--"
  }
]

⚠ Images are returned as SVG so and not in the image/png format. Results may be unexpected when using curl or fetch.

Available filters

Image endpoints have a few filters that you can pick from and combine. greyscale and blur allow you to, well, make your images blurry or greyscale.

https://placewaifu.com/image/200?greyscale

You can also combine the filters as well

https://placewaifu.com/image/200/500?greyscale&blur

Adding new images

If you're interested in adding new images, make sure to head over to the github repository and submit a pull request.