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 |
|---|---|---|
| Copilot Studio | 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) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - 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) |
| 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) |
| Contact | |
|---|---|
| Name | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| 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
- response
- array of Collections
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 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.
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. |
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. |