AI agents for Unsplash
Licensed imagery for generated content. AGNT connects to Unsplash so agents can read what happens there, reason about it, and act — with a receipt for every run.
Content Producer is a ready-made agent that works in Unsplash — free, and it runs on your machine.
Unsplash and AGNT, in brief
| What it does | Lets an AGNT agent read from and act in Unsplash. |
|---|---|
| Connects with | An API key held in the local vault |
| AGNT node | unsplash-api |
| Runs when | A schedule or another workflow fires it |
| Typical build time | Two minutes |
| Where data goes | Nowhere by default — AGNT runs on your machine and credentials never leave it. |
What you can automate
Agents can…
- search and fetch images
- attach imagery to drafts
Teams use it for
- posts illustrated automatically
- image options attached to drafts
- consistent visuals across channels
Build it: the Unsplash workflow
Design goal for Unsplash: posts illustrated automatically; image options attached to drafts; consistent visuals across channels. The template below supplies configurable nodes, not the complete logic for those goals.
Use this Unsplash setup template to arrange the schedule, input review and API operation. Configure the account-specific fields and add your own decision and approval controls before activation.
This is a schema-checked starting point, not an end-to-end tested automation. Replace every CONFIGURE_ value, choose the operations you intend, connect credentials and map source outputs into later inputs. An edge orders steps; it does not supply a condition, an approval gate or a field mapping. Add and test those controls explicitly before any write. Cloud APIs and model providers may receive data. Keep the workflow inactive until tested with fixtures.
{
"id": "d3ce775e-0363-4778-a7ac-f7daef839bf4",
"name": "Unsplash — read, decide, act",
"nodes": [
{
"id": "912d6013-4060-4d61-a204-099a07e5cc2a",
"text": "Run on a schedule",
"x": 512,
"y": 144,
"isEditing": false,
"type": "trigger-timer",
"icon": "clock",
"category": "trigger",
"isSelected": false,
"parameters": {
"fireOnStart": "No",
"scheduleType": "Interval",
"schedule": "Every 15 Minutes"
},
"description": "Setup template for Timer Trigger. This trigger node fires the workflow at specified intervals or at a specific time. Configure credentials, inputs and output mapping before use.",
"error": null,
"isActive": false,
"output": null,
"outputs": {}
},
{
"id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
"text": "Review source and draft",
"x": 512,
"y": 336,
"isEditing": false,
"type": "agnt-agent",
"icon": "agnt",
"category": "action",
"isSelected": false,
"parameters": {
"agentId": "CONFIGURE_AGENTID",
"message": "Read the Unsplash item and decide whether it warrants action. Explain your reasoning.\nSource input: CONFIGURE_SOURCE_INPUT. Produce a reviewable draft only; do not take external actions."
},
"description": "Setup template for Agent Chat. Chat with an AI agent from your agent library. Select an agent and send messages to interact with it within your workflow. Configure credentials, inputs and output mapping before use.",
"error": null,
"isActive": false,
"output": null,
"outputs": {}
},
{
"id": "7bc51c68-dcf2-48db-a026-334f797f9f5e",
"text": "Configure destination in Unsplash",
"x": 512,
"y": 528,
"isEditing": false,
"type": "unsplash-api",
"icon": "connect",
"category": "action",
"isSelected": false,
"parameters": {
"action": "SEARCH_PHOTOS",
"page": 1,
"perPage": 1,
"orientation": "",
"orderBy": "relevant",
"query": "CONFIGURE_QUERY",
"color": ""
},
"description": "Setup template for Unsplash API. Search and download high-quality stock photos from Unsplash. Configure credentials, inputs and output mapping before use.",
"error": null,
"isActive": false,
"output": null,
"outputs": {}
}
],
"edges": [
{
"id": "203cbfb9-60bd-479a-a448-2bcd7ec5174c",
"start": {
"id": "912d6013-4060-4d61-a204-099a07e5cc2a",
"type": "output"
},
"end": {
"id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
"type": "input"
},
"startX": 800,
"startY": 168,
"endX": 512,
"endY": 360
},
{
"id": "9ea4df40-d097-4c41-ad27-10a5173abdae",
"start": {
"id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
"type": "output"
},
"end": {
"id": "7bc51c68-dcf2-48db-a026-334f797f9f5e",
"type": "input"
},
"startX": 800,
"startY": 360,
"endX": 512,
"endY": 552
}
],
"zoomLevel": 1,
"canvasOffsetX": 0,
"canvasOffsetY": 0,
"isTinyNodeMode": false
}
Configure Unsplash API
Search and download high-quality stock photos from Unsplash.
- action — The action to perform on Unsplash Current example:
SEARCH_PHOTOS. - query — Search query for photos Current example:
CONFIGURE_QUERY. - page — Page number (1-1000) Current example:
1. - perPage — Results per page (1-30) Current example:
1. - orientation — Filter by photo orientation Current example:
. - color — Filter by color Current example:
. - orderBy — Sort order for results Current example:
relevant.
Install Content Producer — it runs on Unsplash
Content Producer is a working agent that uses Unsplash. Installing it drops the whole workflow onto your canvas — connected, editable, and yours to change.
Runs on your own machine · See what it does
Imagery without the licensing question
Generated content usually needs a picture, and the picture is where publishing stalls. Pulling licensed imagery as part of the workflow keeps the draft complete rather than blocked on somebody finding something usable.
Consistency across channels
Because selection happens in the same workflow that produces the copy, visual treatment can stay consistent across every channel a piece goes to, instead of varying by whoever assembled each version.
Inside the Unsplash API node
Search and download high-quality stock photos from Unsplash.
What it can do: SEARCH_PHOTOS GET_RANDOM_PHOTO GET_PHOTO LIST_PHOTOS GET_COLLECTIONS GET_COLLECTION_PHOTOS GET_USER_PROFILE GET_USER_PHOTOS DOWNLOAD_PHOTO
Full Unsplash API parameter reference
| Parameter | Type | What it does |
|---|---|---|
actionrequired |
string | The action to perform on Unsplash SEARCH_PHOTOS · GET_RANDOM_PHOTO · GET_PHOTO · LIST_PHOTOS · GET_COLLECTIONS · GET_COLLECTION_PHOTOS · GET_USER_PROFILE · GET_USER_PHOTOS |
query |
string | Search query for photos only when action is SEARCH_PHOTOS or GET_RANDOM_PHOTO |
photoId |
string | The ID of the photo only when action is GET_PHOTO or DOWNLOAD_PHOTO |
collectionId |
string | The ID of the collection only when action is GET_COLLECTION_PHOTOS |
username |
string | Unsplash username only when action is GET_USER_PROFILE or GET_USER_PHOTOS or GET_RANDOM_PHOTO |
pagerequired |
number | Page number (1-1000) |
perPagerequired |
number | Results per page (1-30) |
orientationrequired |
string | Filter by photo orientation · landscape · portrait · squarish |
color |
string | Filter by color · black_and_white · black · white · yellow · orange · red · purple only when action is SEARCH_PHOTOS |
orderByrequired |
string | Sort order for results relevant · latest · oldest · popular |
count |
number | Number of random photos (1-30) only when action is GET_RANDOM_PHOTO |
featured |
string | Limit to featured photos only · true · false only when action is GET_RANDOM_PHOTO |
Every parameter above is read from the shipped unsplash-api node, so it cannot drift from the product.
Connect Unsplash in two minutes
- Download AGNT Community Core — free, local-first, no account needed to run.
- Connect by pasting an API key into AGNT’s vault — stored encrypted on your machine, never uploaded.
- Drop the Unsplash node into a workflow or hand it to an agent — the first run produces a receipt you can read line by line.
Unsplash + AGNT — common questions
Can images be attached to drafts automatically?
Yes — searched and attached as part of the content workflow.
Is attribution handled?
Attribution requirements come with the image; include them in your publishing step.
How is Unsplash connected?
With an API key stored encrypted in the local vault.