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