Easy to use, stylish placeholders
Just add your desired image size (width & height) after our URL, and you'll get a random image.
https://picsum.photos/200/300
To get a square image, just add the size.
https://picsum.photos/200
Specific Image
Get a specific image by adding
/id/{image}
to the
start of the url.
https://picsum.photos/id/77/450/300
Static Random Image
Get the same random image every time based on a
seed, by adding
/seed/{seed}
to the
start of the url.
https://picsum.photos/seed/picsum/450/300
Grayscale
Get a grayscale image by appending
?grayscale
to the end
of the url.
https://picsum.photos/450/300?grayscale
Blur
Get a blurred image by appending
?blur
to the end of
the url.
https://picsum.photos/450/300/?blur
You can adjust the amount of blur by providing a
number between 1
and
10
.
https://picsum.photos/450/300/?blur=2
Advanced Usage
You may combine any of the options above.
For example, to get a specific image that is
grayscale and
blurred.
https://picsum.photos/id/8/450/300?grayscale&blur=2
{
"id": "0",
"author": "Alejandro Escamilla",
"width": 5616,
"height": 3744,
"url": "https://unsplash.com/...",
"download_url": "https://picsum.photos/..."
}
Image Details
Get information about a specific image by using the
the
/id/{id}/info
endpoint.
https://picsum.photos/id/0/info
List Images
Get a list of images by using the
/v2/list
endpoint.
https://picsum.photos/v2/list
The API will return 30 items per page by default.
To request another page, use the
?page
parameter.
To change the amount of items per page, use the
?limit
parameter.
https://picsum.photos/v2/list?page=2&limit=100
[
{
"id": "0",
"author": "Alejandro Escamilla",
"width": 5616,
"height": 3744,
"url": "https://unsplash.com/...",
"download_url": "https://picsum.photos/..."
}
]