Unsplash icon

Unsplash

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

Actions17

User → List Collections

AI-generated

Summary

List a specified user's Unsplash collections, optionally paginating and limiting the results.

Inputs

  • Username (required) — The Unsplash username whose collections you want to list.
  • Return All — Whether to return all collections or limit the number of collections returned.
  • Limit — If 'Return All' is false, the maximum number of collections to retrieve (minimum 1, maximum 5000).
  • Additional Fields — Optional pagination parameters: 'Page' to select the page number (minimum 1), and 'Per Page' to specify the number of collections per request (maximum 30).

Output shape

a list of collection objects corresponding to the specified user's Unsplash collections

If 'Return All' is true, all collections are returned across pages; otherwise, up to 'Limit' collections are returned. Pagination can be controlled via 'Page' and 'Per Page' additional fields parameters. The output is an array of collection records as returned by the Unsplash API under endpoint /users/{username}/collections.

Examples

Example 1: List up to 100 collections of user 'exampleUser'

Set Username to 'exampleUser', Return All to false, and Limit to 100.

Example 2: Retrieve all collections for user 'exampleUser' without pagination limits

Set Username to 'exampleUser' and Return All to true.

Links

Discussion