Unsplash API

api.unsplash.com

Community

Unsplash provides free, high-resolution stock photos contributed by a global community of photographers. Use the API to search for photos by keyword, retrieve photo details with download URLs, browse curated collections, and access user portfolios. All photos are free to use under the Unsplash License.

Auth

api_key

Pricing

free

Spec version

1.0

Base URL

https://api.unsplash.com

Crawl failures

1

Last verified

2026-03-01T11:09:51.000Z

Health

This is a community-maintained manifest. Health monitoring is not available because this service doesn't host its own /.well-known/agent endpoint yet. Learn more about trust levels →

Capabilities

get_photo

location

Retrieve full details for a specific photo by its ID, including EXIF data, location, download links at multiple resolutions, and photographer information.

Detail: https://api.unsplash.com/capabilities/get_photo

get_random_photo

other

Get one or more random photos, optionally filtered by search query, collection, orientation, or topic. Useful for generating varied visual content.

Detail: https://api.unsplash.com/capabilities/get_random_photo

get_user_photos

other

Retrieve photos uploaded by a specific Unsplash user, identified by username. Returns paginated results ordered by most recent.

Detail: https://api.unsplash.com/capabilities/get_user_photos

list_collections

other

List featured photo collections curated by Unsplash editors. Each collection contains a set of thematically related photos.

Detail: https://api.unsplash.com/capabilities/list_collections

search_collections

other

Search for photo collections by keyword query. Returns matching collections with their titles, descriptions, cover photos, and total photo counts.

Detail: https://api.unsplash.com/capabilities/search_collections

search_photos

other

Search for photos by keyword query. Returns paginated results with URLs for different image sizes (raw, full, regular, small, thumb). Supports filtering by orientation and dominant color.

Detail: https://api.unsplash.com/capabilities/search_photos

track_download

other

Track a photo download event. Required by the Unsplash API Terms to be called when a photo is downloaded or used. Returns the actual download URL.

Detail: https://api.unsplash.com/capabilities/track_download

Agent Preview

This is what an AI agent sees when it discovers this service via the Gateway:

Service: Unsplash API
Description: Unsplash provides free, high-resolution stock photos contributed by a global community of photographers. Use the API to search for photos by keyword, retrieve photo details with download URLs, browse curated collections, and access user portfolios. All photos are free to use under the Unsplash License.
Auth: api_key
Capabilities:
  - get_photo: Retrieve full details for a specific photo by its ID, including EXIF data, location, download links at multiple resolutions, and photographer information.
  - get_random_photo: Get one or more random photos, optionally filtered by search query, collection, orientation, or topic. Useful for generating varied visual content.
  - get_user_photos: Retrieve photos uploaded by a specific Unsplash user, identified by username. Returns paginated results ordered by most recent.
  - list_collections: List featured photo collections curated by Unsplash editors. Each collection contains a set of thematically related photos.
  - search_collections: Search for photo collections by keyword query. Returns matching collections with their titles, descriptions, cover photos, and total photo counts.
  - search_photos: Search for photos by keyword query. Returns paginated results with URLs for different image sizes (raw, full, regular, small, thumb). Supports filtering by orientation and dominant color.
  - track_download: Track a photo download event. Required by the Unsplash API Terms to be called when a photo is downloaded or used. Returns the actual download URL.