Unsplash (Independent Publisher)

Unsplash is the internet's source of freely usable images. Over 2 million free high-resolution images brought to you by the world's most generous community of photographers. Unsplash is home to a growing community of photographers - from hobbyists, professionals, emerging brands and everyone in between.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Troy Taylor
URL	https://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

Connector Metadata
Publisher	Troy Taylor, Hitachi Solutions
Website	https://unsplash.com/
Privacy policy	https://unsplash.com/privacy
Categories	Lifestyle and Entertainment

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
Access Key	securestring	The Access Key for this api	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Get a page of photos	Get a single page from the list of all photos.
Get a user's public collections	Retrieve public collections for a given user.
Get a user's public profile	Retrieve public details on a given user.
Get photos from a search	Get a single page from a photo search. Optionally limit your search to a set of categories by supplying the category ID's.
List a user's liked photos	Get a list of photos liked by a user.
List a user's photos	Get a list of photos uploaded by a user.
Retrieve a single photo	Retrieve a single photo.
Retrieve a single random photo	Retrieve a single random photo, given optional filters.

Get a page of photos

Operation ID:

PhotoGetPage

Get a single page from the list of all photos.

Parameters

Name	Key	Required	Type	Description
Page	page		integer	Page number to retrieve. (Optional, default: 1)
Per Page	per_page		integer	Number of items per page. (Optional; default: 10)
Order By	order_by		string	How to sort the photos. Optional. (Valid values: latest, oldest, popular; default: latest)

Returns

response

array of Photos

Get a user's public collections

Operation ID:

UserGetCollections

Retrieve public collections for a given user.

Parameters

Name	Key	Required	Type	Description
Username	username	True	string	The user's username. Required.
Page	page		integer	Page number to retrieve. (Optional, default: 1)
Per Page	per_page		integer	Number of items per page. (Optional; default: 10)

Returns

response

array of Collections

Get a user's public profile

Operation ID:

UserGet

Retrieve public details on a given user.

Parameters

Name	Key	Required	Type	Description
Username	username	True	string	The user's username. Required.
Width	w		integer	Profile image width in pixels.
Height	h		integer	Profile image height in pixels.

Returns

Body

Users

Get photos from a search

Operation ID:

PhotoSearch

Get a single page from a photo search. Optionally limit your search to a set of categories by supplying the category ID's.

Parameters

Name	Key	Required	Type	Description
Query	query	True	string	Search terms.
Category	category	True	string	Category ID('s) to filter search. If multiple, comma-separated.

Returns

response

array of Photos

List a user's liked photos

Operation ID:

UserGetLiked

Get a list of photos liked by a user.

Parameters

Name	Key	Required	Type	Description
Username	username	True	string	The user's username. Required.
Page	page		integer	Page number to retrieve. (Optional, default: 1)
Per Page	per_page		integer	Number of items per page. (Optional; default: 10)
Order By	order_by		string	How to sort the photos. Optional. (Valid values: latest, oldest, popular; default: latest)

Returns

response

array of Photos

List a user's photos

Operation ID:

UserGetPhotos

Get a list of photos uploaded by a user.

Parameters

Name	Key	Required	Type	Description
Username	username	True	string	The user's username. Required.
Page	page		integer	Page number to retrieve. (Optional, default: 1)
Per Page	per_page		integer	Number of items per page. (Optional; default: 10)
Order By	order_by		string	How to sort the photos. Optional. (Valid values: latest, oldest, popular; default: latest)

Returns

response

array of Photos

Retrieve a single photo

Operation ID:

PhotoGet

Retrieve a single photo.

Parameters

Name	Key	Required	Type	Description
ID	id	True	string	The photo’s ID.

Returns

Body

Photo

Retrieve a single random photo

Operation ID:

PhotoGetRandom

Retrieve a single random photo, given optional filters.

Parameters

Name	Key	Required	Type	Description
Collections	collections		string	Public collection ID(‘s) to filter selection. If multiple, comma-separated.
Topics	topics		string	Public topic ID(‘s) to filter selection. If multiple, comma-separated.
Username	username		string	Limit selection to a single user.
Query	query		string	Limit selection to photos matching a search term.
Orientation	orientation		string	Filter by photo orientation. Valid values: landscape, portrait, squarish.
Content Filter	content_filter		string	Limit results by content safety. Default: low.

Returns

Body

Photo

Definitions

Photos

Name	Path	Type	Description
ID	id	string	The identifier.
Width	width	integer	The width in pixels.
Height	height	integer	The height in pixels.
Color	color	string	The color.
Likes	likes	integer	The number of likes.
Liked By User	liked_by_user	boolean	Whether liked by user.
user	user	User
urls	urls	PhotoURLs
links	links	PhotoLinks
categories	categories	array of Category

Photo

Name	Path	Type	Description
ID	id	string	The identifier.
Width	width	integer	The width in pixels.
Height	height	integer	The height in pixels.
Color	color	string	The color.
Likes	likes	integer	The number of likes.
Liked By User	liked_by_user	boolean	Whether liked by user.
user	user	User
urls	urls	PhotoURLs
links	links	PhotoLinks
categories	categories	array of Category
location	location	Location
exif	exif	Exif

Collections

Name	Path	Type	Description
ID	id	integer	The identifier.
Title	title	string	The title.
Published At	published_at	string	The date published at.
Curated	curated	boolean	Whether curated.
cover_photo	cover_photo	Photo
user	user	Users
links	links	UserLinks

Users

Name	Path	Type	Description
Username	username	string	The username.
First Name	first_name	string	The first name.
Last Name	last_name	string	The last name.
Profile URL	portfolio_url	string	The URL of the profile.
Downloads	downloads	integer	The number of downloads.
profile_image	profile_image	ProfileImage
links	links	UserLinks

User

Name	Path	Type	Description
ID	id	string	The identifier.
Username	username	string	The username.
Name	name	string	The name.
profile_image	profile_image	ProfileImage
links	links	UserLinks

ProfileImage

Name	Path	Type	Description
Small	small	string	The small version.
Medium	medium	string	The medium version.
Large	large	string	The large version.
Custom	custom	string	The custom size version.

UserLinks

Name	Path	Type	Description
Self	self	string	The self.
HTML	html	string	The HTML.
Photos	photos	string	The photos.
Likes	likes	string	The likes.

PhotoURLs

Name	Path	Type	Description
RAW	raw	string	The RAW.
Full	full	string	The full.
Regular	regular	string	The regular.
Small	small	string	The small version.
Thumbnail	thumb	string	The thumbnail.

PhotoLinks

Name	Path	Type	Description
Self	self	string	The self.
HTML	html	string	The HTML.
Download	download	string	The download.

Category

Name	Path	Type	Description
ID	id	integer	The identifier.
Title	title	string	The title.
Photo Count	photo_count	integer	The photo count.
links	links	CategoryLinks

CategoryLinks

Name	Path	Type	Description
Self	self	string	The self.
Photos	photos	string	The photos.

Exif

Name	Path	Type	Description
Make	make	string	The camera make.
Model	model	string	The camera model.
Exposure Time	exposure_time	number	The exposure time.
Aperture	aperture	number	The aperture.
Focal Length	focal_length	integer	The focal length.
ISO	iso	integer	The ISO.

Location

Name	Path	Type	Description
City	city	string	The city.
Country	country	string	The country.