--- title: "Unsplash Integration" description: "Search 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." url: https://flowrunner.ai/integrations/unsplash date_modified: 2026-08-04T10:04:16-07:00 --- # Unsplash [Social Media](https://flowrunner.ai/integrations/category/marketing-social) Search 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. [Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 8 actions · API key · available [Unsplash website](https://unsplash.com/) · [Platform Documentation](https://unsplash.com/developers) · Capability data verified 2026-07-28 1. A blog post draft reaches the ready-for-imagery stage in the CMS 2. Search Photos queries the library with the post's topic, filtered to landscape orientation 3. Get Photo pulls full detail on the top candidates, including dimensions and all renditions 4. The agent posts the three best candidates with preview URLs and photographer credits to the content channel 5. The content lead picks the image that fits the piece, or asks for another search with a refined query 6. Trigger Download registers the chosen photo and returns the direct image URL, per Unsplash guidelines 7. The image lands in the CMS media library with the attribution line already composed ## 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 **The stock photo scavenger hunt**: Every post stalls at "needs a hero image" while someone browses tabs of stock sites **Attribution as an afterthought**: Photos get saved and pasted with the photographer credit lost somewhere in the process **Imagery decided one image at a time**: Each page gets whatever the person searching that day happened to like ### With FlowRunner **Candidates arrive pre-searched**: Agents surface on-topic, correctly oriented options with credits attached, ready to pick from **Compliance is built into the pipeline**: Trigger Download fires on every image actually used, and the attribution line writes itself **A curated visual system**: Collections and photographer portfolios feed a consistent image library instead of one-off finds ## Use Case Scenarios ### Every post ships with an image and a credit A draft is marked ready in [WordPress](https://flowrunner.ai/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](https://flowrunner.ai/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](https://flowrunner.ai/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](https://flowrunner.ai/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](https://flowrunner.ai/concepts/human-in-the-loop) step here is not bureaucracy. It is the only participant in the workflow with taste. Agent processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via preferred channel Human decides Agent resumes with decision ## Agent Capabilities 8 actions ### Search 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. **Work at Unsplash?** This integration exposes Unsplash to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/unsplash. Site index: https://flowrunner.ai/llms.txt