Pexels photos and videos, with views, downloads and EXIF, as JSON
Pexels (pexels.com) is a library of free stock photos and videos.
- endpoints
- 28
- credits per call
- 0–2
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
28 active endpoints, on 0, 1 and 2 credit tiers.
- POST/pexels/v1/search_photos1 credit
- POST/pexels/v1/search_videos1 credit
- POST/pexels/v1/search_users1 credit
- POST/pexels/v1/search_collection1 credit
- POST/pexels/v1/suggestions1 credit
- POST/pexels/v1/trending_searches1 credit
- POST/pexels/v1/photo2 credits
- POST/pexels/v1/video2 credits
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Pexels API
5 of 28 endpoints, ready to run
Search photos with the site's own filters
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Pexels endpoints does ReefAPI ship?
28 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Pexels endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Pexels API works
Pexels is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a search to the photographer behind it
Search a photographer's work, open one photo, then their profile and most popular uploads.
His mountain photos: 1,199 results, 24 per page, each with sizes, tags and colours.
Views, downloads, likes, EXIF (Canon EOS 70D, f/8.0, ISO 160, 1/640), file size and every download link.
66,475 followers, 10.2 billion total views, all-time rank 2, plus downloads and likes all time and for the last 30 days.
All 1,760 of his uploads, most popular first, 24 per page.
A photographer's catalogue with the performance of every photo, ready to rank or track.
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": { … },
"meta": {
"api": "pexels",
"endpoint": "search_photos",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Pexels field actually contains
Fields that read differently from how they look. Every row was measured against live pexels.com on 2026-11-19.
| Field | What it holds |
|---|---|
| stats.views / downloads / likes | The numbers the photo or video page prints as Views, Downloads and Likes (photo 691668: 243,149,423 views, 1,796,526 downloads, 7,236 likes). They matched the page on 36 of 36 values across 12 items; a counter can move by one between two reads. |
| uploaded_at / published_at | uploaded_at is the date the page prints as "Date" (when the file was uploaded); published_at is when Pexels made it public. They can be days or months apart (691668: uploaded 2017-11-17, published 2017-11-18). |
| exif.taken_at | The page's "Taken At": the capture date from the file's EXIF. Missing when the file carried none (4 of 16 photos). |
| image.original / image.download_url | original is the full-resolution file; download_url is the link the page's Download button uses (it adds a file name). Both point at the file; the API returns links, not the files. |
| video.files | Every MP4 rendition Pexels has, largest first, each with width, height, fps, a direct link and a download link (video 855986: 4 renditions, 640x360 to 1920x1080). |
| counts.followers / stats_all_time.followers | counts.followers is the profile page's "Followers" (eberhardgross: 66,475). stats_all_time.followers comes from the statistics tab and is a different, larger number (76,374). |
| views_all_time / leaderboard | The profile's "Total Views", "All-time rank" and "30-day rank". They matched the profile page on 4 of 4 photographers. Null where the page shows 0 or a dash. |
| color filter | A 6-digit hex or red, orange, yellow, green, turquoise, blue, violet, purple, pink, brown, black, white, gray. Black, white, gray, 000000 and FFFFFF return the same black-and-white set. Photos only. |
| total | Pexels' own count for the search, capped at 10,000. A search serves 480 results (20 pages of 24), so reachable_total and last_reachable_page tell you where it stops. |
| location | The place name Pexels publishes for a photo (6 of 16 photos had one). Latitude and longitude were empty on all 16. |
Photographer names, socials, websites and PayPal donation links are returned exactly as Pexels publishes them on the photo and profile pages.
Pexels coverage, measured
Every number below was read from live pexels.com on 2026-11-19: 271 calls over 28 actions, 241 of 241 answered, plus 30 checks that wrong inputs get the right error.
24 results per page and 20 pages (480 results) per photo or video search; Pexels' totals stop at 10,000. Every filter changed the count ("lighthouse" photos 9,816: square 93, one person 1,329, last week 1,514, red 5,035; videos 5,973: 60 s and longer 199, 24 fps 515, 8K 9).
Views, downloads and likes matched the pexels.com page on 36 of 36 values (12 photos and videos), photographer name 12 of 12, dimensions and camera 8 of 8. Followers, total views and ranks matched 4 of 4 profiles. 14 of 14 search rows equalled the full record.
Tags, main colour, image sizes, download links and photographer name were filled on 240 of 240 search rows across 10 categories, title and description on 238. EXIF camera data on 11 of 16 photos, a place name on 6 of 16, latitude / longitude on none. Videos: every rendition and link on 9 of 9.
Three consecutive pages repeated no row on 13 of 15 lists. Challenges that share an end date can swap across a page boundary (1 repeat seen); a video search re-sorted one row between two reads 30 seconds apart.
480 results per search and 480 similar items per photo. Followers and the leaderboard stop answering on very deep pages (fine at row 14,400 and 48,000). The all-time uploads leaderboard currently fails on pexels.com itself. Who liked or downloaded an item is not public.
What people build with Pexels
The jobs this data is most often used for.
endpoints
credits per call
Find free stock photos and videos by orientation, colour, people, size, length or 4K for a design or video project.
Track views and downloads of your own Pexels uploads over time.
Rank and research photographers by views, uploads and followers.
Collect trending and popular search terms per country for content planning.
What Pexels data costs
The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/pexels/v1/search_photos",
headers={"x-api-key": REEF_KEY},
json={
"query": "mountain"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Pexels.
Is this the official Pexels API?▾
No. It reads what pexels.com itself shows and adds what the official API leaves out: views, downloads and likes per photo and video, EXIF data, photographer statistics, followers, the leaderboard, challenges and trending searches.
Can I get the view and download counts of a photo?▾
Yes. `photo` and `video` return views, downloads and likes; `media_stats` returns them for up to 200 items in one call, which is the cheap way to track them over time. They matched the pexels.com page on 36 of 36 values checked.
Which search filters work?▾
Every filter on the pexels.com search page, each checked to change the result: for "lighthouse" photos, square orientation cut 9,816 results to 93, one person to 1,329, uploaded last week to 1,514, red to 5,035, width up to 1920 px to 174. Videos add duration, frame rate and 1080p / 4K / 8K.
How many results can one search return?▾
480: Pexels serves 20 pages of 24 for any search, whatever its total says. Narrow with filters or search related terms (each answer lists them with their counts) to reach more.
Can I get a photographer's statistics?▾
Yes. `user` returns total views, downloads, likes and followers all time and for the last 30 days, leaderboard positions, upload counts, bio, socials and donation links. `users_batch` returns up to 100 profiles in one call.
Does it download the image or video files?▾
No. It returns every link: each image size, the original file, the download button's link, and every MP4 rendition with its direct and download link.
Does it work in other languages?▾
Yes. Pass locale (28 languages, for example de or ja-JP) and titles, descriptions, tags and page links come back in that language, and the query is matched in it.
How fresh is the data?▾
Every call reads pexels.com live. Only the tag vocabulary is a list refreshed once a day.
What is the Pexels API?▾
Pexels API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /pexels/v1.
Is the Pexels API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Pexels calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Pexels login or account?▾
No login to Pexels is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Pexels data?▾
The page example is captured from a live search_photos call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Pexels API use?▾
Pexels actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Pexels from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call pexels actions with the same key, credit pool and JSON envelope used by normal REST requests.
43 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Pexels, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-19.