Search Unsplash Photos
Search for high-quality stock photos on Unsplash by keywords. Returns optimized image URLs ready for use.
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 #
Search for high-quality stock photos on Unsplash by keywords. Returns optimized image URLs ready for use.
Add Search Unsplash Photos 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 |
| Search Keywords | Keywords to search for. Use multiple keywords separated by spaces for better results (e.g., 'AI automation startup team', 'mountain landscape sunset', 'coffee office work'). The more specific your keywords, the better the results. |
| Orientation (Optional) | Filter by orientation: landscape, portrait, or squarish. Leave empty for any orientation. Choices: (empty), landscape, portrait, squarish. |
| Color Filter (Optional) | Filter by color: black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, or blue. Leave empty for any color. Choices: (empty), black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue. |
| Sort Order (Optional) | Sort results by: relevant, latest, or popular (default: relevant) Choices: relevant, latest, popular.Example/default shown in the editor: relevant. |
| Select Mode (Optional) | How to select photo: first (first result), random (random from results), or all (return all results as JSON array). Default: random Example/default shown in the editor: random. |
| Results Per Page (Optional) | Number of results to fetch (1-30, default: 10) Example/default shown in the editor: 10. |
| Page Number (Optional) | Page number for pagination (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) |
total |
Total Results Count |
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 selectMode=all) |
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 Random Unsplash Photo
- Get Unsplash Collection Photos
- Get Unsplash Photo by ID
- List Unsplash Collections
- 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.