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
Get a specific image by adding /id/{image}
to the start of the url.
https://picsum.photos/id/237/200/300
You can find a list of all the images here.
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/200/300
Get a grayscale image by appending ?grayscale
to the end of the url.
https://picsum.photos/200/300?grayscale
Get a blurred image by appending ?blur
to the end of the url.
https://picsum.photos/200/300/?blur
You can adjust the amount of blur by providing a number between 1
and 10
.
https://picsum.photos/200/300/?blur=2
You may combine any of the options above.
For example, to get a specific image that is grayscale and blurred.
https://picsum.photos/id/870/200/300?grayscale&blur=2
To request multiple images of the same size in your browser, add the random
query param to prevent the images from being cached:
<img src="https://picsum.photos/200/300?random=1">
<img src="https://picsum.photos/200/300?random=2">
If you need a file ending, you can add .jpg
to the end of the url.
https://picsum.photos/200/300.jpg
To get an image in the WebP format, you can add .webp
to the end of the url.
https://picsum.photos/200/300.webp
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
The Link
header includes pagination information about the next/previous pages
[
{
"id": "0",
"author": "Alejandro Escamilla",
"width": 5616,
"height": 3744,
"url": "https://unsplash.com/...",
"download_url": "https://picsum.photos/..."
}
]
Get information about a specific image by using the /id/{id}/info
and /seed/{seed}/info
endpoints.
https://picsum.photos/id/0/info
https://picsum.photos/seed/picsum/info
You can find out the ID of an image by looking at the Picsum-ID
header, or the User Comment
field in the EXIF metadata.
{
"id": "0",
"author": "Alejandro Escamilla",
"width": 5616,
"height": 3744,
"url": "https://unsplash.com/...",
"download_url": "https://picsum.photos/..."
}