Unsplash
Social MediaSearch Unsplash's library of free high-resolution photography from your flows: agents find photos and curated collections, fetch random on-topic images for dynamic heroes, pull full photo detail and renditions, and register downloads to stay compliant with attribution guidelines.
What This Integration Enables
Unsplash is a library of free high-resolution photography with one rule that most homegrown scripts ignore: when you actually use a photo, you are required to register the download. This connector treats that rule as part of the pipeline, not a footnote. FlowRunner agents search photos and curated collections, pull full photo detail including EXIF and every rendition, fetch random on-topic images for dynamic heroes, and call Trigger Download at the moment of use so the integration stays inside Unsplash's API guidelines by construction. The useful framing: agents are good at searching and shortlisting, and unqualified to judge whether an image fits your brand. So the connector does the finding, and a person does the choosing. - Illustrate blog posts, landing pages, and social content from a shortlist, not a blank search box - Pull random on-topic photos for rotating heroes and backgrounds, orientation-filtered - Curate themed collections and photographer portfolios into a reusable brand image pool - Register every used photo with Trigger Download and carry the credit downstream automatically - Filter by orientation, dominant color, and content safety so candidates fit the layout before anyone looks
Without FlowRunner
With FlowRunner
Use Case Scenarios
Every post ships with an image and a credit
A draft is marked ready in [WordPress](/integrations/wordpress). The agent runs Search Photos on the post's primary topic, filters to landscape, and pulls detail on the top results with Get Photo. The shortlist posts to [Slack](/integrations/slack) with previews and photographer names. The editor taps one. The agent calls Trigger Download, fetches the returned URL, uploads the image to the CMS, and appends the attribution line to the post footer. The post publishes with imagery that was chosen by a person and registered by the pipeline.
The rotating hero that never repeats itself
A weekly flow calls Random Photo with the campaign's theme query and a count of five, registers the selected image with Trigger Download, and pushes it through [Cloudinary](/integrations/cloudinary) for cropping and optimization before it lands on the landing page. The page stays visually fresh without a designer touching it weekly, and because selection runs through an approval step during campaign setup, nothing off-brand goes live on autopilot.
Building the brand image pool once, instead of searching forever
The content team names three photographers whose work fits the brand. On a schedule, Get User Photos pulls each photographer's recent uploads and Search Collections finds themed sets around the quarter's campaign topics. Every candidate logs to a content-planning sheet in [Google Sheets](/integrations/google-sheets) with id, description, and preview URL. When a designer needs an image, they shop the pre-curated pool, and the agent handles Trigger Download and delivery for whichever one they take.
Human-in-Loop Highlight
Trigger Download is where this connector stops browsing and commits. Unsplash's guidelines require registering the download whenever a photo is actually used, and in these workflows that call is immediately followed by the image landing on a published page, a scheduled social post, or a campaign asset that reaches customers with your name on it. A wrong image on a live page is a write to your brand that no API can roll back, and a used photo with a dropped credit is a compliance failure baked into published content. So FlowRunner agents search, shortlist, and stage at machine speed, but Trigger Download fires only after a person has looked at the actual image and said yes. The [human-in-the-loop](/concepts/human-in-the-loop) step here is not bureaucracy. It is the only participant in the workflow with taste.
Agent Capabilities
8 actionsSearch
2- Search Photos Searches the library and returns a paginated envelope of photo objects with id, description, urls, links, and user. Filters by orientation, dominant color, and content safety; orders by relevance or recency. The workhorse behind every shortlist.
- Search Collections Searches curated collections by keyword, returning collection objects with title, description, total_photos, and cover photo. Used to browse themed sets instead of individual images.
Photos
4- List Photos Returns a page of the editorial feed, ordered by recency, popularity, views, or downloads. Used for discovery flows that start from what is trending rather than a query.
- Get Photo Retrieves full detail for one photo: dimensions, color, EXIF, location, tags, stats, and every rendition URL. The step that qualifies a candidate before it goes to review.
- Random Photo Retrieves one or more random photos, optionally filtered by query and orientation. Returns a single object for a count of one and an array otherwise. Built for rotating heroes and backgrounds.
- Trigger Download Registers a download and returns a temporary direct image URL. Required by Unsplash guidelines whenever a photo is actually used, and it does not count against the hourly rate limit. The commit point of every workflow on this page.
Users
2- Get User Retrieves a photographer's public profile by username: bio, location, portfolio links, and aggregate stats. No leading @ in the username.
- Get User Photos Returns a page of a specific photographer's uploads with pagination, ordering, and orientation filtering. The action behind photographer-based curation.
Frequently Asked Questions
What can FlowRunner do with Unsplash?
FlowRunner agents can run Search Photos, Search Collections, and List Photos in Unsplash, plus 5 more actions.
Does connecting Unsplash to FlowRunner require OAuth?
No. Unsplash connects to FlowRunner with an API key, no OAuth flow required.
Can Unsplash trigger a FlowRunner workflow automatically?
Unsplash doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Unsplash
$100 in credits. No card required. Connect in minutes.