Just add your desired image size (width & height) after our URL, and you'll get a random image.
To get a square image, just add the size.
Get a specific image by adding /id/{image} to the start of the url.
https://picsum.photos/id/237/200/300You can find a list of all the images here.
Get a grayscale image by appending ?grayscale to the end of the url.
https://picsum.photos/200/300?grayscaleGet a blurred image by appending ?blur to the end of the url.
https://picsum.photos/200/300/?blurYou can adjust the amount of blur by providing a number between 1 and 10.
https://picsum.photos/200/300/?blur=2You 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=2To request multiple images of the same size in your browser, you need to add a random parameter 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">Get a list of images by using the /v2/list endpoint.
https://picsum.photos/v2/listThe 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=100The 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/..."
}
]