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.
/pexels/v1/search_photos1 creditSearch 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words, as typed in the pexels.com search bar. |
| orientation | optional | landscape · portrait · square | landscape, portrait or square ('lighthouse' photos: 9,816 → square 93). |
| size | optional | small · medium · large | Minimum original size: small, medium, large ('lighthouse' photos: large 5,050). |
| people_count | optional | 0 · 1 · 2 · 3_plus | Number of people in the shot: 0, 1, 2 or 3_plus (3+ accepted). 'lighthouse': 1 → 1,329. |
| people_age | optional | baby · child · teenager · adult · senior_adult | Age of the people shown: baby, child, teenager, adult, senior_adult. |
| date_from | optional | last_24_hours · last_week · last_month · last_year | Uploaded within: last_24_hours, last_week, last_month, last_year ('lighthouse' photos: last_week 1,514). |
| photographer | optional | — | 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. |
| color | optional | — | 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_width | optional | 1–20000 | Minimum width in px of the original ('lighthouse': 3840 → 7,934). Photos only. |
| max_width | optional | 1–20000 | Maximum width in px ('lighthouse': 1920 → 174). |
| min_height | optional | 1–20000 | Minimum height in px. |
| max_height | optional | 1–20000 | Maximum height in px. |
| page = 1 | optional | 1–20 | Page 1-20. Pexels serves 24 results per page and 20 pages (480 results) per search, whatever the total says. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/search_videos1 creditSearch 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words, as typed in the pexels.com search bar. |
| orientation | optional | landscape · portrait · square | landscape, portrait or square ('lighthouse' photos: 9,816 → square 93). |
| size | optional | small · medium · large | Minimum original size: small, medium, large ('lighthouse' photos: large 5,050). |
| people_count | optional | 0 · 1 · 2 · 3_plus | Number of people in the shot: 0, 1, 2 or 3_plus (3+ accepted). 'lighthouse': 1 → 1,329. |
| people_age | optional | baby · child · teenager · adult · senior_adult | Age of the people shown: baby, child, teenager, adult, senior_adult. |
| date_from | optional | last_24_hours · last_week · last_month · last_year | Uploaded within: last_24_hours, last_week, last_month, last_year ('lighthouse' photos: last_week 1,514). |
| photographer | optional | — | 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_duration | optional | 1–3600 | Minimum length in seconds ('lighthouse' videos: 60 → 201). |
| max_duration | optional | 1–3600 | Maximum length in seconds ('lighthouse' videos: 10 → 1,872). |
| frame_rate | optional | 24 · 25 · 30 · 50 · 60_plus | 24, 25, 30, 50 or 60_plus fps ('lighthouse' videos: 24 → 518). |
| resolution | optional | 1080p · 4K · 8K | 1080p, 4K or 8K ('lighthouse' videos: 8K → 11). |
| page = 1 | optional | 1–20 | Page 1-20 (24 results per page, 480 per search). |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/search_users1 creditSearch 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words, as typed in the pexels.com search bar. |
| page = 1 | optional | 1– | Page number, 1-based. |
/pexels/v1/search_collection1 creditThe 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words, as typed in the pexels.com search bar. |
/pexels/v1/suggestions1 creditSearch-bar autocomplete: the terms pexels.com suggests for a prefix ('mount' → mountain, mountains, mount fuji … up to 15 measured).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | The start of a search term. |
/pexels/v1/trending_searches1 creditWhat people search on Pexels right now: `popular` (the all-time most searched terms, 10 measured) or `trending` (rising terms, 19 worldwide), worldwide or for one of the 8 countries the site's /popular-searches page publishes. Each term with a cover photo and its result count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| type = trending | optional | trending · popular | trending (default) or popular. |
| media_type | optional | photos · videos | photos or videos: the cover image and result counts follow it. |
| country | optional | br · de · es · fr · gb · in · tr · us | br, de, es, fr, gb (uk), in, tr or us — the 8 countries pexels.com publishes; any other country silently returns the worldwide list, so it is rejected. |
/pexels/v1/photo2 creditsEverything 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | required | — | 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-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/video2 creditsEverything 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | required | — | 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-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/media_batch2 creditsUp 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`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| ids | required | — | 1-12 media ids or links, comma separated. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/media_stats1 creditViews, 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| ids | required | — | 1-200 media ids or links, comma separated. |
/pexels/v1/similar1 creditMedia 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | required | — | 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 = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/user2 creditsA 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user | required | — | Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/). |
/pexels/v1/user_media1 creditEvery 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user | required | — | Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/). |
| sort = recent | optional | recent · popular · portfolio | recent (default), popular, or portfolio: the selection the photographer pinned to their profile (counts.portfolio_media; user 3052: 100). portfolio takes no type filter. |
| type = all | optional | all · photos · videos | all (default), photos or videos (Pixabay: photos 8,663, videos 1,669). |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/user_followers1 creditWho 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user | required | — | Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/). |
| direction = followers | optional | followers · following | followers (default) or following. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
/pexels/v1/user_collections1 creditThe public collections a photographer made (title, description, media / photo / video counts, preview images).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user | required | — | Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/). |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
/pexels/v1/users_batch1 creditUp 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`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| ids | required | — | 1-100 numeric Pexels user ids, comma separated. |
/pexels/v1/similar_users1 creditPhotographers Pexels suggests next to a profile (16 measured), each as a full profile.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user | required | — | Pexels user id (121938), handle (@eberhardgross / eberhardgross) or profile link (https://www.pexels.com/@eberhardgross/). |
/pexels/v1/leaderboard1 creditThe 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| metric = views | optional | views · uploads | views (default) or uploads (approved uploads). |
| span = last_30_days | optional | last_30_days · all_time | last_30_days (default, as the leaderboard page opens) or all_time (views only: uploads + all_time answers HTTP 500 on Pexels itself). |
| heroes_only = false | optional | — | Only Pexels Heroes (all-time views: 3,235 heroes). |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
/pexels/v1/collections1 creditPexels' curated collections: `featured` (the /discover directory, 1,150), `shortlist` (curated shortlists, 133) or `popular` (the 3 the discover page heads with).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| kind = featured | optional | featured · shortlist · popular | featured (default), shortlist or popular. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
/pexels/v1/collection2 creditsOne collection: title, description, media / photo / video counts, curators, preview images and its tags.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| collection | required | — | Collection id (cwgidat), slug (mighty-mountains-cwgidat) or https://www.pexels.com/collections/<slug>/ link. |
/pexels/v1/collection_media1 creditEvery photo and video in a collection, in the collection's order, with real paging.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| collection | required | — | Collection id (cwgidat), slug (mighty-mountains-cwgidat) or https://www.pexels.com/collections/<slug>/ link. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/challenges1 creditPexels photo / video challenges, newest first (253 measured): title, dates, prize, sponsor, entry and photographer counts, winners count, featured and winning shots.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 12 | optional | 1–40 | Rows per page, 1-40 (default 12). Pexels honours larger pages (200 measured); 40 keeps one answer under ~300 KB. |
/pexels/v1/challenge1 creditOne challenge with its full description, subtitle, rules (tips and conditions), terms link, prize and sponsor, dates and counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| challenge | required | — | Challenge id (664), slug (close-to-home) or https://www.pexels.com/challenges/<slug>/ link. |
/pexels/v1/challenge_media1 creditThe 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| challenge | required | — | Challenge id (664), slug (close-to-home) or https://www.pexels.com/challenges/<slug>/ link. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/feed1 creditThe 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`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| kind = curated | optional | curated · new_photos · new_videos · popular_videos | curated (default, the home page's hand-picked feed), new_photos, new_videos or popular_videos. |
| cursor | optional | — | The `next_cursor` of the previous page (omit for the first page). |
| per_page = 24 | optional | 1–80 | Rows per page, 1-80 (default 24). Pexels honours larger pages (200 measured); 80 keeps one answer under ~300 KB. |
| locale = en-US | optional | en-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-RU | Pexels 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. |
/pexels/v1/blog_posts1 creditThe 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| post_type | optional | photo_story · hero_story · news · resource · podcast · photography | photo_story, hero_story, news, resource, podcast or photography. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 12 | optional | 1–40 | Rows per page, 1-40 (default 12). Pexels honours larger pages (200 measured); 40 keeps one answer under ~300 KB. |
/pexels/v1/blog_post1 creditOne Pexels blog post with its full text (markdown and plain text), author and cover photo.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| post | required | — | Post slug (elas-por-elas) or a pexels.com/blog/<type>/<slug>/ link. |
curl -X POST https://api.reefapi.com/pexels/v1/search_photos \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"mountain"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}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.
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.
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.
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.