Actions17
- Photo Actions
- Collection Actions
- User Actions
Collection → List Featured
AI-generatedSummary
Retrieve featured collections from Unsplash with optional pagination and limit controls.
Inputs
- Return All — Whether to return all results or limit the number of returned collections.
- Limit — Maximum number of collections to return when not returning all.
- Additional Fields — Optional pagination fields including page number and number of results per page (max 30).
Output shape
A list of collection objects in JSON format.
If 'Return All' is true, it fetches all featured collections without a limit. Otherwise, it limits results to the specified 'Limit'. Pagination can be controlled with 'Page' and 'Per Page' fields. The API request is made to the '/collections/featured' endpoint.
Examples
Example 1: List up to 50 featured collections on page 1 with 10 items per page
Return All set to false, Limit set to 50, Additional Fields page=1, perPage=10
Example 2: List all featured collections without limit
Return All set to true