UnsplashInstall

Summary

Search photos on Unsplash using a required text query and optional filters such as order, collections, content filter level, color, orientation, and language.

Inputs

• Query (required) — The search string used to find matching photos.
• Return All — Whether to return all matching photos without limit.
• Limit — Maximum number of photos to return when Return All is false.
• Additional Fields — Optional pagination settings including Page number and number of results per page (max 30).
• Search Filters — Optional filters to refine the search results such as Order By (relevant or latest), Collections (comma separated collection IDs), Content Filter (low or high), Color, Orientation, and Language code.

Output shape

a list of photo objects matching the search criteria

The photos are returned as an array under the 'results' property from Unsplash API, combined and paginated according to the limit and Return All parameter. Pagination parameters can be set via Additional Fields. Errors occur if unsupported parameters or invalid resource/operation combinations are used.

Examples

Example 1: Search for photos with query 'sunrise', returning up to 50 photos relevant to the query.

Query='sunrise', Return All=false, Limit=50, no additional filters.

Example 2: Search for photos with query 'mountains' filtered by color 'blue' and orientation 'landscape', returning all results.

Query='mountains', Return All=true, Search Filters color='blue', orientation='landscape'.

Links

• n8n community nodes installation guide