Unsplash
App · Images & Design · 3 actions
Search Unsplash's free stock photo library and pull images into your workflows.
Actions
| Action | What it does |
|---|---|
| Get a random photo | Fetch one random Unsplash photo, optionally matching a search term. |
| Get photo | Fetch details for a single Unsplash photo. |
| Search photos | Search Unsplash's free stock photo library. |
Get a random photo
Fetch one random Unsplash photo, optionally matching a search term.
Inputs
- Search terms
querytext - Optional. Limit the random pick to photos matching these terms, for example 'mountains'.
- Orientation
orientationtext - Optional. Only pick a photo in this shape.One of:
landscape,portrait,squarish.
Outputs
colortext- Dominant color as a hex code, for example '#2c5f2d'
descriptiontext- Photo caption, falling back to its alt text
heightnumber- Image height in pixels
idtext- Unsplash photo ID
page_urltext- Unsplash page for the photo, for use when crediting it
photographer_nametext- Photographer's name -- Unsplash's licence requires crediting them
photographer_urltext- Photographer's Unsplash profile URL, for the credit link
thumbnail_urltext- Small preview image URL
urltext- Full-size image URL
widthnumber- Image width in pixels
Example output
{
"color": "#2c5f2d",
"description": "A misty forest at dawn",
"height": 2667,
"id": "Dwu85P9SOIk",
"page_url": "https://unsplash.com/photos/Dwu85P9SOIk",
"photographer_name": "Jane Doe",
"photographer_url": "https://unsplash.com/@janedoe",
"thumbnail_url": "https://images.unsplash.com/photo-1417325384643?w=200",
"url": "https://images.unsplash.com/photo-1417325384643?w=1080",
"width": 4000
}Get photo
Fetch details for a single Unsplash photo.
Inputs
- Photo ID
photo_idtextRequired - The Unsplash photo ID, as returned by Search photos.
Outputs
colortext- Dominant color as a hex code, for example '#2c5f2d'
descriptiontext- Photo caption, falling back to its alt text
heightnumber- Image height in pixels
idtext- Unsplash photo ID
page_urltext- Unsplash page for the photo, for use when crediting it
photographer_nametext- Photographer's name -- Unsplash's licence requires crediting them
photographer_urltext- Photographer's Unsplash profile URL, for the credit link
thumbnail_urltext- Small preview image URL
urltext- Full-size image URL
widthnumber- Image width in pixels
Example output
{
"color": "#2c5f2d",
"description": "A misty forest at dawn",
"height": 2667,
"id": "Dwu85P9SOIk",
"page_url": "https://unsplash.com/photos/Dwu85P9SOIk",
"photographer_name": "Jane Doe",
"photographer_url": "https://unsplash.com/@janedoe",
"thumbnail_url": "https://images.unsplash.com/photo-1417325384643?w=200",
"url": "https://images.unsplash.com/photo-1417325384643?w=1080",
"width": 4000
}Search photos
Search Unsplash's free stock photo library.
Inputs
- Search terms
querytextRequired - What to search for, for example 'misty forest'.
- Results per page
per_pagenumber - How many photos to return (1-30).From 1 to 30. Default:
10. - Page
pagenumber - Which page of results to return, starting at 1.At least 1. Default:
1. - Orientation
orientationtext - Optional. Only return photos in this shape.One of:
landscape,portrait,squarish.
Outputs
photoslist- Photos on the requested page
totalnumber- Total photos matching the search
Example output
{
"photos": [
{
"color": "#2c5f2d",
"description": "A misty forest at dawn",
"height": 2667,
"id": "Dwu85P9SOIk",
"page_url": "https://unsplash.com/photos/Dwu85P9SOIk",
"photographer_name": "Jane Doe",
"photographer_url": "https://unsplash.com/@janedoe",
"thumbnail_url": "https://images.unsplash.com/photo-1417325384643?w=200",
"url": "https://images.unsplash.com/photo-1417325384643?w=1080",
"width": 4000
}
],
"total": 1284
}