> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Unsplash

> Connect Unsplash to your Atako agents — 11 read and 0 write actions.

Let your agents search for, browse and download royalty-free photos from Unsplash.

## Connection

* **Authentication**: API key (Access Key).

<Note>
  Sign in at unsplash.com/developers → Your apps → New Application → Accept the terms → Keys → copy the Access Key. Mode démo : 50 req/h ; production sur demande.

  See [Unsplash's documentation](https://unsplash.com/documentation).
</Note>

## Read actions (11)

| Action | Description |
| - | - |
| `get_photo` | Retrieve a single photo by ID. Always credit the photographer (user.name + user.links.html). |
| `get_random_photo` | Retrieve a random photo. All arguments optional: query (string — limit to photos matching a search term), orientation ("landscape" \| "portrait" \| "squarish"), count (integer 1–30, default 1 — number of photos to return; when set, response is an array). Always credit the photographer (user.name + user.links.html). |
| `get_stats` | Get Unsplash platform-wide totals (photos, downloads, views, etc.). No arguments. Free — consumes no credits. |
| `get_user` | Retrieve a user's public profile. Arguments: username (string, required). |
| `list_collection_photos` | List photos in a collection. Arguments: id (string, required — collection ID), page (integer, optional — default 1), per\_page (integer 1–30, optional — default 10). Always credit the photographer (user.name + user.links.html). |
| `list_photos` | List photos from the editorial feed. Arguments: page (integer, optional — page number, default 1), per\_page (integer 1–30, optional — results per page, default 10). Always credit the photographer (user.name + user.links.html). |
| `list_topic_photos` | List photos in a topic. Arguments: id\_or\_slug (string, required — topic ID or slug), page (integer, optional — default 1), per\_page (integer 1–30, optional — default 10), order\_by ("latest" \| "oldest" \| "popular" \| "views" \| "downloads", optional — default "latest"). Always credit the photographer (user.name + user.links.html). |
| `list_topics` | List topics (photo categories). No required arguments. |
| `search_collections` | Search collections by keyword. Arguments: query (string, required), page (integer, optional — default 1), per\_page (integer 1–30, optional — default 10). |
| `search_photos` | Search photos by keyword. Arguments: query (string, required — the search term), page (integer, optional — page number, default 1), per\_page (integer 1–30, optional — results per page, default 10), orientation ("landscape" \| "portrait" \| "squarish", optional), color ("black\_and\_white" \| "black" \| "white" \| "yellow" \| "orange" \| "red" \| "purple" \| "magenta" \| "green" \| "teal" \| "blue", optional), order\_by ("relevant" \| "latest", optional — default "relevant"). Always credit the photographer (user.name + user.links.html). |
| `track_download` | Track a photo download (fulfils Unsplash's mandatory download-tracking obligation). Arguments: id (string, required — the photo ID). Call this before using/downloading a photo per Unsplash API guidelines. |

## Write actions (0)

This connector is read-only — it exposes no write actions.

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.