Share via


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

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

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

Get a user's public profile

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

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

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

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

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.

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.

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