Unsplash icon

Unsplash

Interact with the Unsplash API - Find, download, and manage high-quality images

Actions17

User → List Photos

AI-generated

Summary

Retrieve a list of photos uploaded by a specified Unsplash user, optionally controlling pagination, ordering, and the number of photos returned.

Inputs

  • Username (required) — The Unsplash username of the user whose photos you want to list.
  • Return All — Whether to return all photos or limit the results.
  • Limit — Maximum number of photos to return when not returning all.
  • Additional Fields — Optional pagination parameters: page number and number of results per page (up to 30).
  • Order By — The order to list the photos by: newest first (latest), oldest first (oldest), or most popular (popular).

Output shape

a list of photo objects from Unsplash uploaded by the specified user

If 'Return All' is set to true, all photos are fetched across pages until limit or data exhaustion; otherwise, results are limited by 'Limit'. Pagination parameters 'Page' and 'Per Page' further control which subset of data is retrieved. The API supports ordering by latest, oldest, or popular.

Examples

Example 1: List 10 latest photos of Unsplash user 'example_user'

Set Username to 'example_user', Return All to false, Limit to 10, and Order By to 'Latest'.

Links

Discussion