Media · Integration

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.

Install Content Producer → Get AGNT free

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

Take the simplest useful version: a scheduled run begins in Unsplash. Instead of a rule firing blindly, an agent reads the item in full, works out whether it matters and what it means, and then decides whether to search and fetch images. Over a week that turns posts illustrated automatically from something a person checks into something that reports to a person.

The shape is deliberately small. A trigger watching Unsplash, an agent that judges what arrived, and one action taken only when that judgment warrants it. Everything below is the actual definition, not an illustration of one.

The whole flow runs locally against your own Unsplash account. Deciding to take no action counts as an outcome and is recorded like any other.

Unsplash — read, decide, actpaste into a new workflow

{
  "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": {
        "interval": "15",
        "unit": "minutes"
      },
      "description": "Checks Unsplash every fifteen minutes.",
      "error": null,
      "isActive": false,
      "output": null,
      "outputs": {}
    },
    {
      "id": "23dba8ed-787a-43c7-a0f0-65a4b997048a",
      "text": "Read it and decide",
      "x": 512,
      "y": 336,
      "isEditing": false,
      "type": "agnt-agent",
      "icon": "agnt",
      "category": "action",
      "isSelected": false,
      "parameters": {
        "instructions": "Read the Unsplash item and decide whether it warrants action. Explain your reasoning."
      },
      "description": "Judges the Unsplash item against criteria you wrote in plain language.",
      "error": null,
      "isActive": false,
      "output": null,
      "outputs": {}
    },
    {
      "id": "7bc51c68-dcf2-48db-a026-334f797f9f5e",
      "text": "Act in Unsplash",
      "x": 512,
      "y": 528,
      "isEditing": false,
      "type": "unsplash-api",
      "icon": "connect",
      "category": "action",
      "isSelected": false,
      "parameters": {
        "action": "SEARCH_PHOTOS"
      },
      "description": "Runs SEARCH_PHOTOS on your behalf.",
      "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
}

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.

Install Content Producer → Don’t have AGNT? Get it free

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
`action`required	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
`page`required	number	Page number (1-1000)
`perPage`required	number	Results per page (1-30)
`orientation`required	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
`orderBy`required	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.