Share via


Pexels (Independent Publisher) (Preview)

Pexels is a free stock photo and video website and app that helps designers, bloggers, and everyone who is looking for visuals to find great photos and videos that can be downloaded and used for free.

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 Vivek Bavishi
URL https://thatapiguy.tech
Email vivekbavishi@thatapiguy.tech
Connector Metadata
Publisher That API Guy
Website https://www.pexels.com/
Privacy policy https://www.pexels.com/privacy-policy/
Categories Content and Files

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
API Key securestring The API Key for Pexels api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get Photo

Retrieve a specific Photo from its id.

Get Video

Retrieve a specific Video from its id.

List Curated Photos

Retrieves a list of real-time photos curated by the Pexels team.

List Popular Videos

Retrieves a list of the current popular videos.

Search for Photos

Search Pexels for any photos that you would like. For example your query could be something broad like Nature, Tigers, People. Or it could be something specific like Group of people working.

Search for Videos

Search Pexels for any videos that you would like. For example your query could be something broad like Nature, Tigers, People. Or it could be something specific like Group of people working.

Get Photo

Retrieve a specific Photo from its id.

Parameters

Name Key Required Type Description
Photo ID
photo-id True string

The id of the photo you are requesting.

Returns

Name Path Type Description
id
id integer

The id of the photo.

width
width integer

The real width of the photo in pixels.

height
height integer

The real height of the photo in pixels.

url
url string

The Pexels URL where the photo is located.

photographer
photographer string

The name of the photographer who took the photo.

photographer_url
photographer_url string

The URL of the photographer's Pexels profile.

photographer_id
photographer_id integer

The id of the photographer.

avg_color
avg_color string

The average color of the photo. Useful for a placeholder while the image loads.

original
src.original string

The image without any size changes. It will be the same as the width and height attributes.

large
src.large string

The image resized to W 940px X H 650px DPR 1.

large2x
src.large2x string

The image resized W 940px X H 650px DPR 2.

medium
src.medium string

The image scaled proportionally so that it's new height is 350px.

small
src.small string

The image scaled proportionally so that it's new height is 130px.

portrait
src.portrait string

The image cropped to W 800px X H 1200px.

landscape
src.landscape string

The image cropped to W 1200px X H 627px.

tiny
src.tiny string

The image cropped to W 280px X H 200px.

liked
liked boolean

Tells if the photo is liked by you or not.

alt
alt string

Text description of the photo for use in the alt attribute.

Get Video

Retrieve a specific Video from its id.

Parameters

Name Key Required Type Description
Video ID
video-id True integer

The id of the video you are requesting.

Returns

Name Path Type Description
id
id integer

The id of the video.

width
width integer

The real width of the photo in pixels.

height
height integer

The real height of the photo in pixels.

url
url string

The Pexels URL where the video is located.

image
image string

URL to a screenshot of the video.

duration
duration integer

The duration of the video in seconds.

id
user.id integer

The id of the photographer.

name
user.name string

The name of the videographer.

url
user.url string

The URL of the videographer's Pexels profile.

video_files
video_files array of object

An array of different sized versions of the video.

id
video_files.id integer

The id of the video_file.

quality
video_files.quality string

The video quality of the video_file.

file_type
video_files.file_type string

The video format of the video_file.

width
video_files.width integer

The width of the video_file in pixels.

height
video_files.height integer

The height of the video_file in pixels.

link
video_files.link string

A link to where the video_file is hosted.

video_pictures
video_pictures array of object

An array of preview pictures of the video.

id
video_pictures.id integer

The id of the video_picture.

picture
video_pictures.picture string

A link to the preview image.

nr
video_pictures.nr integer

Image number.

List Curated Photos

Retrieves a list of real-time photos curated by the Pexels team.

Parameters

Name Key Required Type Description
Results Per Page
per_page integer

The number of results you are requesting per page. Default value is 15 and Max limit is 80.

Page Number
page integer

The page number you are requesting.

Returns

Name Path Type Description
total_results
total_results integer

The total number of results for the request.

page
page integer

The current page number.

per_page
per_page integer

The number of results returned with each page.

photos
photos array of object

An array of Photo objects.

id
photos.id integer

The id of the photo.

width
photos.width integer

The real width of the photo in pixels.

height
photos.height integer

The real height of the photo in pixels.

url
photos.url string

The Pexels URL where the photo is located.

photographer
photos.photographer string

The name of the photographer who took the photo.

photographer_url
photos.photographer_url string

The URL of the photographer's Pexels profile.

photographer_id
photos.photographer_id integer

The id of the photographer.

avg_color
photos.avg_color string

The average color of the photo. Useful for a placeholder while the image loads.

original
photos.src.original string

The image without any size changes. It will be the same as the width and height attributes.

large
photos.src.large string

The image resized to W 940px X H 650px DPR 1.

large2x
photos.src.large2x string

The image resized W 940px X H 650px DPR 2.

medium
photos.src.medium string

The image scaled proportionally so that it's new height is 350px.

small
photos.src.small string

The image scaled proportionally so that it's new height is 130px.

portrait
photos.src.portrait string

The image cropped to W 800px X H 1200px.

landscape
photos.src.landscape string

The image cropped to W 1200px X H 627px.

tiny
photos.src.tiny string

The image cropped to W 280px X H 200px.

liked
photos.liked boolean

Tells if the photo is liked by you or not.

alt
photos.alt string

Text description of the photo for use in the alt attribute.

prev_page
prev_page string

URL for the previous page of results, if applicable.

next_page
next_page string

URL for the next page of results, if applicable.

Retrieves a list of the current popular videos.

Parameters

Name Key Required Type Description
Min. Width
min_width integer

The minimum width in pixels of the returned videos.

Min. Width
min_height integer

The minimum height in pixels of the returned videos.

Min. Width
min_duration integer

The minimum duration in seconds of the returned videos.

Min. Width
max_duration integer

The max duration in seconds of the returned videos.

Page Number
page integer

The page number you are requesting.

Per Page
per_page integer

The number of results you are requesting per page. Default value is 15 and Max limit is 80

Returns

Name Path Type Description
total_results
total_results integer

The total number of results for the request.

page
page integer

The current page number.

per_page
per_page integer

The number of results returned with each page.

url
url string

The Pexels URL for the current search query.

videos
videos array of object

An array of Video objects.

id
videos.id integer

The id of the video.

width
videos.width integer

The real width of the photo in pixels.

height
videos.height integer

The real height of the photo in pixels.

url
videos.url string

The Pexels URL where the video is located.

image
videos.image string

URL to a screenshot of the video.

duration
videos.duration integer

The duration of the video in seconds.

id
videos.user.id integer

The id of the photographer.

name
videos.user.name string

The name of the videographer.

url
videos.user.url string

The URL of the videographer's Pexels profile.

video_files
videos.video_files array of object

An array of different sized versions of the video.

id
videos.video_files.id integer

The id of the video_file.

quality
videos.video_files.quality string

The video quality of the video_file.

file_type
videos.video_files.file_type string

The video format of the video_file.

width
videos.video_files.width integer

The width of the video_file in pixels.

height
videos.video_files.height integer

The height of the video_file in pixels.

link
videos.video_files.link string

A link to where the video_file is hosted.

video_pictures
videos.video_pictures array of object

An array of preview pictures of the video.

id
videos.video_pictures.id integer

The id of the video_picture.

picture
videos.video_pictures.picture string

A link to the preview image.

nr
videos.video_pictures.nr integer

Image number.

prev_page
prev_page string

URL for the previous page of results, if applicable.

next_page
next_page string

URL for the next page of results, if applicable.

Search for Photos

Search Pexels for any photos that you would like. For example your query could be something broad like Nature, Tigers, People. Or it could be something specific like Group of people working.

Parameters

Name Key Required Type Description
Search Query
query True string

The search query.

Orientation
orientation string

Desired photo orientation.

Size
size string

Minimum photo size.

Color
color string

Desired photo color. Supported colors: red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white or any hexidecimal color code (eg. #ffffff).

Locale
locale string

The locale of the search you are performing.

Page Number
page integer

The page number you are requesting.

Per Page
per_page integer

The number of results you are requesting per page. Default value is 15 and Max limit is 80

Returns

Name Path Type Description
total_results
total_results integer

The total number of results for the request.

page
page integer

The current page number.

per_page
per_page integer

The number of results returned with each page.

photos
photos array of object

An array of Photo objects.

id
photos.id integer

The id of the photo.

width
photos.width integer

The real width of the photo in pixels.

height
photos.height integer

The real height of the photo in pixels.

url
photos.url string

The Pexels URL where the photo is located.

photographer
photos.photographer string

The name of the photographer who took the photo.

photographer_url
photos.photographer_url string

The URL of the photographer's Pexels profile.

photographer_id
photos.photographer_id integer

The id of the photographer.

avg_color
photos.avg_color string

The average color of the photo. Useful for a placeholder while the image loads.

original
photos.src.original string

The image without any size changes. It will be the same as the width and height attributes.

large
photos.src.large string

The image resized to W 940px X H 650px DPR 1.

large2x
photos.src.large2x string

The image resized W 940px X H 650px DPR 2.

medium
photos.src.medium string

The image scaled proportionally so that it's new height is 350px.

small
photos.src.small string

The image scaled proportionally so that it's new height is 130px.

portrait
photos.src.portrait string

The image cropped to W 800px X H 1200px.

landscape
photos.src.landscape string

The image cropped to W 1200px X H 627px.

tiny
photos.src.tiny string

The image cropped to W 280px X H 200px.

liked
photos.liked boolean

Tells if the photo is liked by you or not.

alt
photos.alt string

Text description of the photo for use in the alt attribute.

prev_page
prev_page string

URL for the previous page of results, if applicable.

next_page
next_page string

URL for the next page of results, if applicable.

Search for Videos

Search Pexels for any videos that you would like. For example your query could be something broad like Nature, Tigers, People. Or it could be something specific like Group of people working.

Parameters

Name Key Required Type Description
Search Query
query True string

The search query.

Orientation
orientation string

Desired video orientation.

Size
size string

Minimum video size. The current supported sizes are: large(4K), medium(Full HD) or small(HD).

Locale
locale string

The locale of the search you are performing.

Page Number
page integer

The page number you are requesting.

Per Page
per_page integer

The number of results you are requesting per page. Default value is 15 and Max limit is 80

Returns

Name Path Type Description
total_results
total_results integer

The total number of results for the request.

page
page integer

The current page number.

per_page
per_page integer

The number of results returned with each page.

url
url string

The Pexels URL for the current search query.

videos
videos array of object

An array of Video objects.

id
videos.id integer

The id of the video.

width
videos.width integer

The real width of the photo in pixels.

height
videos.height integer

The real height of the photo in pixels.

url
videos.url string

The Pexels URL where the video is located.

image
videos.image string

URL to a screenshot of the video.

duration
videos.duration integer

The duration of the video in seconds.

id
videos.user.id integer

The id of the photographer.

name
videos.user.name string

The name of the videographer.

url
videos.user.url string

The URL of the videographer's Pexels profile.

video_files
videos.video_files array of object

An array of different sized versions of the video.

id
videos.video_files.id integer

The id of the video_file.

quality
videos.video_files.quality string

The video quality of the video_file.

file_type
videos.video_files.file_type string

The video format of the video_file.

width
videos.video_files.width integer

The width of the video_file in pixels.

height
videos.video_files.height integer

The height of the video_file in pixels.

link
videos.video_files.link string

A link to where the video_file is hosted.

video_pictures
videos.video_pictures array of object

An array of preview pictures of the video.

id
videos.video_pictures.id integer

The id of the video_picture.

picture
videos.video_pictures.picture string

A link to the preview image.

nr
videos.video_pictures.nr integer

Image number.

prev_page
prev_page string

URL for the previous page of results, if applicable.

next_page
next_page string

URL for the next page of results, if applicable.