Pexels
App · Images & Design · 5 actions
Search Pexels' library of free stock photos and videos, and pull direct download links for use in your workflows.
Actions
| Action | What it does |
|---|---|
| Get a photo | Look up one photo by its Pexels ID, including every download size and the photographer's details. |
| List curated photos | List the photos Pexels' editors are currently featuring on the home page, newest first. |
| List popular videos | List the videos currently most popular on Pexels, optionally limited to a range of clip lengths. |
| Search photos | Search Pexels' library of free stock photos by keyword, with optional filters for orientation, minimum size, and colour. |
| Search videos | Search Pexels' library of free stock videos by keyword, with optional filters for orientation and minimum resolution. |
Get a photo
Look up one photo by its Pexels ID, including every download size and the photographer's details.
Inputs
- Photo ID
photo_idtextRequired - The photo's Pexels ID, as returned by Search photos or List curated photos.
Outputs
alttext- A short description of the photo, usable as alt text
avg_colortext- The photo's average colour as a hex code, handy as a placeholder background while the image loads
heightnumber- Height of the original photo in pixels
large_urltext- Direct link to a large (roughly 940px wide) version
medium_urltext- Direct link to a medium (roughly 350px tall) version
original_urltext- Direct link to the full-resolution image file
photo_idnumber- The photo's Pexels ID. Use with Get a photo.
photographertext- Name of the photographer, for the attribution Pexels asks for
photographer_urltext- Link to the photographer's Pexels profile
tiny_urltext- Direct link to a thumbnail-sized version
urltext- Link to the photo's page on Pexels
widthnumber- Width of the original photo in pixels
Example output
{
"alt": "Brown Rocks During Golden Hour",
"avg_color": "#978E82",
"height": 3024,
"large_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?w=940",
"medium_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?h=350",
"original_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg",
"photo_id": 2014422,
"photographer": "Joey Farina",
"photographer_url": "https://www.pexels.com/@joey",
"tiny_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?h=200",
"url": "https://www.pexels.com/photo/brown-rocks-during-golden-hour-2014422/",
"width": 3024
}List curated photos
List the photos Pexels' editors are currently featuring on the home page, newest first.
Inputs
- Page
pagenumber - Which page of results to return. Defaults to the first page.At least 1. Default:
1. - Results per page
per_pagenumber - How many results to return (1-80).From 1 to 80. Default:
15.
Outputs
pagenumber- The page of results this is
per_pagenumber- How many results this page holds
photoslist- The curated photos
total_resultsnumber- How many results match in total
Example output
{
"page": 1,
"per_page": 15,
"photos": [
{
"alt": "Brown Rocks During Golden Hour",
"avg_color": "#978E82",
"height": 3024,
"large_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?w=940",
"medium_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?h=350",
"original_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg",
"photo_id": 2014422,
"photographer": "Joey Farina",
"photographer_url": "https://www.pexels.com/@joey",
"tiny_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?h=200",
"url": "https://www.pexels.com/photo/brown-rocks-during-golden-hour-2014422/",
"width": 3024
}
],
"total_results": 8000
}List popular videos
List the videos currently most popular on Pexels, optionally limited to a range of clip lengths.
Inputs
- Shortest clip (seconds)
min_durationnumber - Optional. Leave out videos shorter than this.At least 0.
- Longest clip (seconds)
max_durationnumber - Optional. Leave out videos longer than this.At least 0.
- Page
pagenumber - Which page of results to return. Defaults to the first page.At least 1. Default:
1. - Results per page
per_pagenumber - How many results to return (1-80).From 1 to 80. Default:
15.
Outputs
pagenumber- The page of results this is
per_pagenumber- How many results this page holds
total_resultsnumber- How many results match in total
videoslist- The popular videos
Example output
{
"page": 1,
"per_page": 15,
"total_results": 4000,
"videos": [
{
"download_url": "https://player.vimeo.com/external/342571552.hd.mp4",
"duration": 22,
"file_type": "video/mp4",
"height": 1920,
"quality": "hd",
"thumbnail_url": "https://images.pexels.com/videos/2499611/free-video-2499611.jpg",
"url": "https://www.pexels.com/video/2499611/",
"video_id": 2499611,
"videographer": "Joey Farina",
"videographer_url": "https://www.pexels.com/@joey",
"width": 1080
}
]
}Search photos
Search Pexels' library of free stock photos by keyword, with optional filters for orientation, minimum size, and colour.
Inputs
- Search term
querytextRequired - What to look for, for example 'mountain sunrise' or 'office desk'.
- Orientation
orientationtext - Optional. Only return photos in this shape.One of:
landscape,portrait,square. - Minimum size
sizetext - Optional. Only return photos at least this large.One of:
large(Large (24MP and up)),medium(Medium (12MP and up)),small(Small (4MP and up)). - Colour
colortext - Optional. Only return photos in this colour -- either a name such as 'red' or 'turquoise', or a hex code such as '#ff7f50'.
- Search language
localetext - Optional. The language the search term is written in, for example 'en-US' or 'pt-BR'.
- Page
pagenumber - Which page of results to return. Defaults to the first page.At least 1. Default:
1. - Results per page
per_pagenumber - How many results to return (1-80).From 1 to 80. Default:
15.
Outputs
pagenumber- The page of results this is
per_pagenumber- How many results this page holds
photoslist- The matching photos
total_resultsnumber- How many results match in total
Example output
{
"page": 1,
"per_page": 15,
"photos": [
{
"alt": "Brown Rocks During Golden Hour",
"avg_color": "#978E82",
"height": 3024,
"large_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?w=940",
"medium_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?h=350",
"original_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg",
"photo_id": 2014422,
"photographer": "Joey Farina",
"photographer_url": "https://www.pexels.com/@joey",
"tiny_url": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?h=200",
"url": "https://www.pexels.com/photo/brown-rocks-during-golden-hour-2014422/",
"width": 3024
}
],
"total_results": 8000
}Search videos
Search Pexels' library of free stock videos by keyword, with optional filters for orientation and minimum resolution.
Inputs
- Search term
querytextRequired - What to look for, for example 'city timelapse' or 'ocean waves'.
- Orientation
orientationtext - Optional. Only return videos in this shape.One of:
landscape,portrait,square. - Minimum resolution
sizetext - Optional. Only return videos at least this large.One of:
large(Large (4K and up)),medium(Medium (Full HD and up)),small(Small (HD and up)). - Search language
localetext - Optional. The language the search term is written in, for example 'en-US' or 'pt-BR'.
- Page
pagenumber - Which page of results to return. Defaults to the first page.At least 1. Default:
1. - Results per page
per_pagenumber - How many results to return (1-80).From 1 to 80. Default:
15.
Outputs
pagenumber- The page of results this is
per_pagenumber- How many results this page holds
total_resultsnumber- How many results match in total
videoslist- The matching videos
Example output
{
"page": 1,
"per_page": 15,
"total_results": 1200,
"videos": [
{
"download_url": "https://player.vimeo.com/external/342571552.hd.mp4",
"duration": 22,
"file_type": "video/mp4",
"height": 1920,
"quality": "hd",
"thumbnail_url": "https://images.pexels.com/videos/2499611/free-video-2499611.jpg",
"url": "https://www.pexels.com/video/2499611/",
"video_id": 2499611,
"videographer": "Joey Farina",
"videographer_url": "https://www.pexels.com/@joey",
"width": 1080
}
]
}