> ## 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 — 10 read and 1 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 (10)

| 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). |

## Write actions (1)

| Action           | Description                                                                                                                                                                                                                                   |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `track_download` | Track a photo download. Per Unsplash API guidelines, this endpoint MUST be called every time a photo is downloaded or used in an application. Arguments: id (string, required — the photo ID). This is the only action requiring write scope. |

## 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.