Media · Integration
UnsplashAGNT

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 doesLets an AGNT agent read from and act in Unsplash.
Connects withAn API key held in the local vault
AGNT nodeunsplash-api
Runs whenA schedule or another workflow fires it
Typical build timeTwo minutes
Where data goesNowhere 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.

Unsplash workflow: run on a schedule → review source and draft → configure destination in unsplash TRIGGER trigger-timer Run on a schedule Configure activation ACTION agnt-agent Review source and draft Configure inputs ACTION unsplash-api Configure destination in Unsplash Configure inputs
Configuration example for Unsplash. API and model calls may send data to your selected providers.
Unsplash — read, decide, actSetup template · configure 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.

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
ParameterTypeWhat 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

  1. Download AGNT Community Core — free, local-first, no account needed to run.
  2. Connect by pasting an API key into AGNT’s vault — stored encrypted on your machine, never uploaded.
  3. 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.

Works well with

AirtableAsanaDiscordGitHubGmailGoogle Calendar

Explore

All integrations →

Give AI a job. Get the proof.

Download free See pricing