Connection
- Authentication: API key (Access Key).
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.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Connect Unsplash to your Atako agents — 10 read and 1 write actions.
| 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). |
| 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. |