Get Random Unsplash Photo
Get random high-quality photos from Unsplash, optionally filtered by keywords or orientation.
Plan availability #
| Feature | Free | Starter | Pro | Enterprise |
|---|---|---|---|---|
| Active workflows | 3 | 10 | 45 | Unlimited |
Allowances follow the published Chatigram pricing page. Your organization’s Billing & Plans screen confirms its subscription and current usage. Plans can change. Plan information reviewed 2026-11-10.
When to use this node #
Get random high-quality photos from Unsplash, optionally filtered by keywords or orientation.
Add Get Random Unsplash Photo to a workflow branch using the node picker. Configure its fields in the inspector, then connect the next step.
Before you begin #
Connect Unsplash in App Connections first. Select the intended account in this node; an account connected to a different service is not interchangeable. Available actions depend on the permissions granted to that connection.
Configure the fields #
| Field | What to enter |
|---|---|
| Unsplash Account | Connected Unsplash account |
| Keywords (Optional) | Optional keywords to filter random photos (e.g., 'nature', 'technology', 'business') |
| Orientation (Optional) | Filter by orientation: landscape, portrait, or squarish. Leave empty for any orientation. Choices: (empty), landscape, portrait, squarish. |
| Featured Only (Optional) | Get only featured photos: true or false (default: false) Choices: false, true.Example/default shown in the editor: false. |
| Number of Photos (Optional) | Number of random photos to get (1-30, default: 1) Example/default shown in the editor: 1. |
Use the result #
Choose the output from the variable picker in a later step. Output names below identify the values supplied by this node; the picker inserts the correct reference for your node instance.
| Output | Meaning / label |
|---|---|
success |
Success Status (true/false) |
found |
Photos Found (true/false) |
count |
Number of Photos Returned |
photoId |
Photo ID |
description |
Photo Description |
photographer |
Photographer Name |
photographerUsername |
Photographer Username |
photographerUrl |
Photographer Profile URL |
imageUrl |
Optimized Image URL (1200x630) |
imageUrlOriginal |
Original Image URL |
imageUrlRaw |
Raw Image URL (for custom sizing) |
imageUrlFull |
Full Size Image URL |
imageUrlSmall |
Small Image URL |
imageUrlThumb |
Thumbnail URL |
width |
Image Width (pixels) |
height |
Image Height (pixels) |
color |
Dominant Color (hex) |
downloadUrl |
Download Tracking URL |
photos |
All Photos (JSON array, if count>1) |
Connect the next step #
Connect the continuation shown on the canvas. Some nodes calculate their branches from the configured options. Read each branch label in the editor and connect the paths your workflow needs.
Test it in a workflow #
- Configure this node with a small, recognizable test input or a test resource.
- Check the variables from preceding steps and the connection selected in the inspector.
- Save the workflow. For event-driven flows, generate the actual event; use Run only for a Manual workflow.
- Open Workflow Activity and check the outcome before enabling wider use.
If something goes wrong #
- Reconnect the account if authorization has expired, then verify its permissions on the specific resource.
- Check empty variables, selected resource IDs, and any fields that appeared after resource selection.
- Check the failed step in Workflow Activity before retrying. If the action may already have completed, inspect the destination first to avoid duplicates.
- Follow the troubleshooting guide for a symptom-by-symptom checklist.
Related guides #
- Work with variables
- Understand branches and error handling
- Browse all nodes
- Get Unsplash Collection Photos
- Get Unsplash Photo by ID
- List Unsplash Collections
- Search Unsplash Photos
- Track Unsplash Download
Catalog coverage #
This is the currently documented selection. Chatigram continues to add nodes, triggers, App Connections, and integrations. Use each page’s review date and the current application selectors to check what is available now; this catalog is not a fixed limit on future features.