Unsplash icon

Unsplash

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

Actions17

Photo → List

AI-generated

Summary

List photos from Unsplash according to specified pagination and sorting criteria.

Inputs

  • Return All — Boolean flag to determine whether to return all photos or limit the number of results.
  • Limit — Maximum number of photos to return when 'Return All' is false, between 1 and 5000.
  • Additional Fields — Additional optional pagination fields including 'Page' (page number) and 'Per Page' (number of results per request, max 30).
  • Order By — Sort order of the photos, which can be 'latest', 'oldest', or 'popular'.

Output shape

a list of photo objects from Unsplash

If 'Return All' is true, the operation retrieves all available photos matching the criteria, paginating automatically. If false, up to 'Limit' photos are returned. The results respect the specified page number and per page limits for pagination and are sorted according to 'Order By'. The data is returned as an array of photo JSON objects.

Examples

Example 1: Retrieve first 50 latest photos

Return All: false, Limit: 50, Additional Fields: default (Page:1, Per Page:10), Order By: latest

Example 2: Retrieve all popular photos with custom pagination

Return All: true, Additional Fields: Page:1, Per Page:30, Order By: popular

Links

Discussion