Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Pexels API page →
docs / pexels

Pexels

Pexels' free stock photos and videos as JSON: search with every filter the site offers, views, downloads and likes per photo, EXIF camera data, every download link, and photographer profiles with all-time statistics and followers.

base /pexels/v128 endpoints
post/pexels/v1/search_photos1 credit

Search Pexels photos with every filter the pexels.com search page offers: orientation, size, dominant colour, number and age of people, upload date, width / height range and photographer, in any of 28 site languages. 24 photos per page, 20 pages (480 photos) per search. Page 1 also carries Pexels' own photo / video / user totals and related searches with their result counts.

ParameterAllowed / rangeDescription
queryrequired—Search words, as typed in the pexels.com search bar.
orientationoptionallandscape · portrait · squarelandscape, portrait or square ('lighthouse' photos: 9,816 → square 93).
sizeoptionalsmall · medium · largeMinimum original size: small, medium, large ('lighthouse' photos: large 5,050).
people_countoptional0 · 1 · 2 · 3_plusNumber of people in the shot: 0, 1, 2 or 3_plus (3+ accepted). 'lighthouse': 1 → 1,329.
people_ageoptionalbaby · child · teenager · adult · senior_adultAge of the people shown: baby, child, teenager, adult, senior_adult.
date_fromoptionallast_24_hours · last_week · last_month · last_yearUploaded within: last_24_hours, last_week, last_month, last_year ('lighthouse' photos: last_week 1,514).
photographeroptional—Only this photographer's media: user id, handle or profile link ('mountain' photos: 10,000+ → 1,199 by @eberhardgross). A handle costs one extra lookup.
coloroptional—Dominant colour: a 6-digit hex (F44336, #2196F3) or red, orange, yellow, green, turquoise, blue, violet, purple, pink, brown, black, white, gray. Pexels maps it to the nearest palette colour; black, white, gray, 000000 and FFFFFF all return the same black-and-white set (measured). Photos only.
min_widthoptional1–20000Minimum width in px of the original ('lighthouse': 3840 → 7,934). Photos only.
max_widthoptional1–20000Maximum width in px ('lighthouse': 1920 → 174).
min_heightoptional1–20000Minimum height in px.
max_heightoptional1–20000Maximum height in px.
page = 1optional1–20Page 1-20. Pexels serves 24 results per page and 20 pages (480 results) per search, whatever the total says.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/search_videos1 credit

Search Pexels videos with the site's video filters: orientation, size, people count / age, upload date, duration range, frame rate, resolution (1080p / 4K / 8K) and photographer. Every row carries every MP4 rendition with its download link. 24 per page, 20 pages per search.

ParameterAllowed / rangeDescription
queryrequired—Search words, as typed in the pexels.com search bar.
orientationoptionallandscape · portrait · squarelandscape, portrait or square ('lighthouse' photos: 9,816 → square 93).
sizeoptionalsmall · medium · largeMinimum original size: small, medium, large ('lighthouse' photos: large 5,050).
people_countoptional0 · 1 · 2 · 3_plusNumber of people in the shot: 0, 1, 2 or 3_plus (3+ accepted). 'lighthouse': 1 → 1,329.
people_ageoptionalbaby · child · teenager · adult · senior_adultAge of the people shown: baby, child, teenager, adult, senior_adult.
date_fromoptionallast_24_hours · last_week · last_month · last_yearUploaded within: last_24_hours, last_week, last_month, last_year ('lighthouse' photos: last_week 1,514).
photographeroptional—Only this photographer's media: user id, handle or profile link ('mountain' photos: 10,000+ → 1,199 by @eberhardgross). A handle costs one extra lookup.
min_durationoptional1–3600Minimum length in seconds ('lighthouse' videos: 60 → 201).
max_durationoptional1–3600Maximum length in seconds ('lighthouse' videos: 10 → 1,872).
frame_rateoptional24 · 25 · 30 · 50 · 60_plus24, 25, 30, 50 or 60_plus fps ('lighthouse' videos: 24 → 518).
resolutionoptional1080p · 4K · 8K1080p, 4K or 8K ('lighthouse' videos: 8K → 11).
page = 1optional1–20Page 1-20 (24 results per page, 480 per search).
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/search_users1 credit

Search Pexels photographers and videographers by name or handle. Each row is the full public profile (bio, socials, donation links, hero badges, follower / upload counts, all-time and 30-day views, leaderboard positions, 4 preview photos). 24 per page.

ParameterAllowed / rangeDescription
queryrequired—Search words, as typed in the pexels.com search bar.
page = 1optional1–Page number, 1-based.
Try in playground →
post/pexels/v1/search_collection1 credit

The curated collection Pexels attaches to a search term (the banner on its search page), e.g. 'forest' → its forest collection. NOT_FOUND when Pexels has none for that term.

ParameterAllowed / rangeDescription
queryrequired—Search words, as typed in the pexels.com search bar.
Try in playground →
post/pexels/v1/suggestions1 credit

Search-bar autocomplete: the terms pexels.com suggests for a prefix ('mount' → mountain, mountains, mount fuji … up to 15 measured).

ParameterAllowed / rangeDescription
queryrequired—The start of a search term.
Try in playground →
post/pexels/v1/photo2 credits

Everything the pexels.com photo page shows for one photo: title, description, tags, colours, dimensions, every image size and the original download link, EXIF (camera, make, aperture, focal length, ISO, shutter speed, software, date taken), file size, location, content-safety ratings, views / downloads / likes, upload and publish dates, the photographer card and the page link in every translated language. A video id returns the video record (type tells).

ParameterAllowed / rangeDescription
idrequired—Pexels media id (691668) or any pexels.com photo / video link (https://www.pexels.com/photo/<slug>-691668/, localized links and images.pexels.com / videos.pexels.com file links included). Photos and videos share one id space.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/video2 credits

Everything the pexels.com video page shows for one video: title, description, tags, duration, fps, every MP4 rendition (SD → 4K) with its direct and download link, thumbnails, views / downloads / likes, dates, the creator card and translated page links. A photo id returns the photo record.

ParameterAllowed / rangeDescription
idrequired—Pexels media id (691668) or any pexels.com photo / video link (https://www.pexels.com/photo/<slug>-691668/, localized links and images.pexels.com / videos.pexels.com file links included). Photos and videos share one id space.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/media_batch2 credits

Up to 12 photos / videos in one call (Pexels' own bulk endpoint answers at most 12): each full media record plus its views / downloads / likes. No EXIF (that is per photo: `photo`). Ids Pexels does not know come back in `not_found`.

ParameterAllowed / rangeDescription
idsrequired—1-12 media ids or links, comma separated.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/media_stats1 credit

Views, downloads and likes for up to 200 photos / videos in ONE upstream request — the cheap way to track counters over time. Pexels answers 0 / 0 / 0 for an id it does not know, so an all-zero row is flagged `all_zero` rather than guessed.

ParameterAllowed / rangeDescription
idsrequired—1-200 media ids or links, comma separated.
Try in playground →
post/pexels/v1/similar1 credit

Media Pexels shows as similar to a photo or video (photos for a photo, videos for a video). Pexels reports the full total (1,157 for photo 691668) but serves the first 480; a page that would cross row 480 is rejected with the last page for your per_page.

ParameterAllowed / rangeDescription
idrequired—Pexels media id (691668) or any pexels.com photo / video link (https://www.pexels.com/photo/<slug>-691668/, localized links and images.pexels.com / videos.pexels.com file links included). Photos and videos share one id space.
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/user2 credits

A Pexels photographer's public profile as the profile page shows it (Total Views, 30-day rank, All-time rank, Challenges Won, Followers, Following, uploads, bio, website, socials, donation links, hero badges, preview photos) plus the statistics tab: all-time and last-30-days views, downloads, likes and followers.

ParameterAllowed / rangeDescription
userrequired—Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/).
Try in playground →
post/pexels/v1/user_media1 credit

Every photo and video a photographer uploaded, newest first or most popular first, optionally only photos or only videos, or their pinned portfolio, with real paging (Pixabay: 10,332 media; eberhardgross: 1,760).

ParameterAllowed / rangeDescription
userrequired—Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/).
sort = recentoptionalrecent · popular · portfoliorecent (default), popular, or portfolio: the selection the photographer pinned to their profile (counts.portfolio_media; user 3052: 100). portfolio takes no type filter.
type = alloptionalall · photos · videosall (default), photos or videos (Pixabay: photos 8,663, videos 1,669).
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/user_followers1 credit

Who follows a photographer, or whom they follow, each as a full profile. Real paging; Pexels times out (HTTP 504) on very deep pages — measured fine at row 14,400, timing out at row 24,000.

ParameterAllowed / rangeDescription
userrequired—Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/).
direction = followersoptionalfollowers · followingfollowers (default) or following.
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
Try in playground →
post/pexels/v1/user_collections1 credit

The public collections a photographer made (title, description, media / photo / video counts, preview images).

ParameterAllowed / rangeDescription
userrequired—Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/).
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
Try in playground →
post/pexels/v1/users_batch1 credit

Up to 100 photographer profiles in ONE upstream request (Pexels' own bulk endpoint; 120 measured): name, bio, socials, donation links, hero badges, follower / upload counts, all-time and 30-day views. Numeric user ids only (the bulk endpoint ignores handles). Unknown ids come back in `not_found`.

ParameterAllowed / rangeDescription
idsrequired—1-100 numeric Pexels user ids, comma separated.
Try in playground →
post/pexels/v1/similar_users1 credit

Photographers Pexels suggests next to a profile (16 measured), each as a full profile.

ParameterAllowed / rangeDescription
userrequired—Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/).
Try in playground →
post/pexels/v1/leaderboard1 credit

The pexels.com photographer leaderboard: by views or by uploads, all time or the last 30 days, optionally heroes only (865,689 ranked users by all-time views). Each row is a full profile with its rank. Pexels times out on very deep pages (fine at row 48,000, 504 at row 96,000). The all-time uploads board fails on Pexels' side (its own page answers HTTP 500, 2026-11-19).

ParameterAllowed / rangeDescription
metric = viewsoptionalviews · uploadsviews (default) or uploads (approved uploads).
span = last_30_daysoptionallast_30_days · all_timelast_30_days (default, as the leaderboard page opens) or all_time (views only: uploads + all_time answers HTTP 500 on Pexels itself).
heroes_only = falseoptional—Only Pexels Heroes (all-time views: 3,235 heroes).
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
Try in playground →
post/pexels/v1/collections1 credit

Pexels' curated collections: `featured` (the /discover directory, 1,150), `shortlist` (curated shortlists, 133) or `popular` (the 3 the discover page heads with).

ParameterAllowed / rangeDescription
kind = featuredoptionalfeatured · shortlist · popularfeatured (default), shortlist or popular.
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
Try in playground →
post/pexels/v1/collection2 credits

One collection: title, description, media / photo / video counts, curators, preview images and its tags.

ParameterAllowed / rangeDescription
collectionrequired—Collection id (cwgidat), slug (mighty-mountains-cwgidat) or https://www.pexels.com/collections/<slug>/ link.
Try in playground →
post/pexels/v1/collection_media1 credit

Every photo and video in a collection, in the collection's order, with real paging.

ParameterAllowed / rangeDescription
collectionrequired—Collection id (cwgidat), slug (mighty-mountains-cwgidat) or https://www.pexels.com/collections/<slug>/ link.
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/challenges1 credit

Pexels photo / video challenges, newest first (253 measured): title, dates, prize, sponsor, entry and photographer counts, winners count, featured and winning shots.

ParameterAllowed / rangeDescription
page = 1optional1–Page number, 1-based.
per_page = 12optional1–40Rows per page, 1-40 (default 12). Pexels honours larger pages (200 measured); 40 keeps one answer under ~300 KB.
Try in playground →
post/pexels/v1/challenge1 credit

One challenge with its full description, subtitle, rules (tips and conditions), terms link, prize and sponsor, dates and counts.

ParameterAllowed / rangeDescription
challengerequired—Challenge id (664), slug (close-to-home) or https://www.pexels.com/challenges/<slug>/ link.
Try in playground →
post/pexels/v1/challenge_media1 credit

The photos and videos entered in a challenge (4,766 for 'Close to Home' on 2026-11-19), with real paging. A slug costs one extra lookup (the entries endpoint takes only the numeric id).

ParameterAllowed / rangeDescription
challengerequired—Challenge id (664), slug (close-to-home) or https://www.pexels.com/challenges/<slug>/ link.
page = 1optional1–Page number, 1-based.
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/feed1 credit

The pexels.com browse feeds: `curated` (the home page's hand-picked photos and videos), `new_photos` and `new_videos` (the newest approved uploads, 12 per page) or `popular_videos` (the videos tab, 18 per page). Pages by cursor: pass `next_cursor` back as `cursor`.

ParameterAllowed / rangeDescription
kind = curatedoptionalcurated · new_photos · new_videos · popular_videoscurated (default, the home page's hand-picked feed), new_photos, new_videos or popular_videos.
cursoroptional—The `next_cursor` of the previous page (omit for the first page).
per_page = 24optional1–80Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB.
locale = en-USoptionalen-US · pt-BR · es-ES · ca-ES · de-DE · it-IT · fr-FR · sv-SE · id-ID · pl-PL · ja-JP · zh-TW · zh-CN · ko-KR · th-TH · nl-NL · hu-HU · vi-VN · cs-CZ · da-DK · fi-FI · uk-UA · el-GR · ro-RO · nb-NO · sk-SK · tr-TR · ru-RUPexels site language (28 locales; `de` = de-DE). Titles, descriptions, tags and page links come back in that language, and a search query is matched in that language.
Try in playground →
post/pexels/v1/blog_posts1 credit

The Pexels blog (185 posts on 2026-11-19): photo stories, hero stories, news, resources, podcasts and photography guides, newest first, each with its full text in the site's own markdown, author, cover photo and publish date. Filter by post type (photography: 49).

ParameterAllowed / rangeDescription
post_typeoptionalphoto_story · hero_story · news · resource · podcast · photographyphoto_story, hero_story, news, resource, podcast or photography.
page = 1optional1–Page number, 1-based.
per_page = 12optional1–40Rows per page, 1-40 (default 12). Pexels honours larger pages (200 measured); 40 keeps one answer under ~300 KB.
Try in playground →
post/pexels/v1/blog_post1 credit

One Pexels blog post with its full text (markdown and plain text), author and cover photo.

ParameterAllowed / rangeDescription
postrequired—Post slug (elas-por-elas) or a pexels.com/blog/<type>/<slug>/ link.
Try in playground →
post/pexels/v1/tagsfree

Pexels' tag vocabulary (42,233 tags on 2026-11-19), filterable by a substring or prefix. Served from a list refreshed once a day.

ParameterAllowed / rangeDescription
containsoptional—Only tags containing this text (case-insensitive).
prefixoptional—Only tags starting with this text.
page = 1optional1–Page number, 1-based.
per_page = 100optional1–500Rows per page, 1-500 (default 100).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.