Unsplash

🔑 BYO Key — Media

Search and use free stock photos from Unsplash. Over 3 million high-resolution images. Attribution required: credit the photographer, use the returned image URLs directly (hotlinking) and call track-download when a photo is used.

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

unsplash_access_key

Access Key

Access Key from unsplash.com/developers → your app → Keys. Not the Secret Key.

Get your API key at unsplash.com →

Try it with your AI assistant

Once WebsitePublisher is connected to your AI assistant, paste one of these into the chat. Replace the parts in [brackets] with your own details.

ChatGPT Claude Other assistants

@WebsitePublisher find a free Unsplash photo of [topic] and use it as the hero image on my homepage, with the photographer credited

@WebsitePublisher search Unsplash for landscape photos of [topic] and add the best three to my [page] with photo credits

@WebsitePublisher show me a few portrait Unsplash photos of [topic] so I can pick one for my team section

With WebsitePublisher, find a free Unsplash photo of [topic] and use it as the hero image on my homepage, with the photographer credited

With WebsitePublisher, search Unsplash for landscape photos of [topic] and add the best three to my [page] with photo credits

With WebsitePublisher, show me a few portrait Unsplash photos of [topic] so I can pick one for my team section

With WebsitePublisher, find a free Unsplash photo of [topic] and use it as the hero image on my homepage, with the photographer credited

With WebsitePublisher, search Unsplash for landscape photos of [topic] and add the best three to my [page] with photo credits

With WebsitePublisher, show me a few portrait Unsplash photos of [topic] so I can pick one for my team section

Endpoints (4)

GET search-photos

Search Unsplash for photos by keyword. Returns up to 10 results with URLs, photographer name, and download links.

Field	Type	Required	Description
`query`	string	✓ Yes	Search query (e.g. "mountain landscape", "office workspace").
`orientation`	string	No	Photo orientation: "landscape", "portrait", or "squarish". Default: any.

GET get-photo

Get full details for an Unsplash photo: high-res URLs, photographer, description, EXIF data, and download link.

Field	Type	Required	Description
`photo_id`	string	✓ Yes	Unsplash photo ID (e.g. "abc123XYZ").

GET random-photo

Get a random Unsplash photo. Optionally filter by search query. Great for hero images and backgrounds.

Field	Type	Required	Description
`query`	string	No	Optional keyword filter (e.g. "nature", "technology").
`orientation`	string	No	Photo orientation: "landscape", "portrait", or "squarish".

GET track-download

Trigger the download event for a photo that is used on a site. Required by the Unsplash API guidelines each time a photo is used. Pass the photo ID, optionally with the ixid from its links.download_location URL.

Field	Type	Required	Description
`photo_id`	string	✓ Yes	Unsplash photo ID (e.g. "abc123XYZ").
`ixid`	string	No	Optional ixid value from the photo's links.download_location URL.

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
search-photos	`unsplash_search_photos`
get-photo	`unsplash_get_photo`
random-photo	`unsplash_random_photo`
track-download	`unsplash_track_download`

← Back to all integrations