The Pexels API enables programmatic access to the full Pexels content library, including photos, videos. All content is available free of charge, and you are welcome to use Pexels content for anything you'd like, as long as it is within our Guidelines.
Whenever you are doing an API request make sure to show a prominent link to Pexels. You can use a text link (e.g. "Photos provided by Pexels") or a link with our logo.
Always credit our photographers when possible (e.g. "Photo by John Doe on Pexels" with a link to the photo page on Pexels).
You may not copy or replicate core functionality of Pexels (including making Pexels content available as a wallpaper app).
Do not abuse the API. By default, the API is rate-limited to 200 requests per hour and 20,000 requests per month. You may contact us to request a higher limit, but please include examples, or be prepared to give a demo, that clearly shows your use of the API with attribution. If you meet our API terms, you can get unlimited requests for free.
Abuse of the Pexels API, including but not limited to attempting to work around the rate limit, will lead to termination of your API access.
Authorization is required for the Pexels API. Anyone with a Pexels account can request an API key, which you will receive instantly.
composer require devscast/pexelsCreate an instance of the Pexels API Client by passing in your API token as parameter.
// ...
use Devscast\Pexels\Client;
// ...
$pexels = new Client(token: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxx');This endpoint enables you to search Pexels for any topic 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.
$photos = $pexels->searchPhotos('Tigers');
// landscape photos only
$photos = $pexels->searchPhotos('Tigers', new SearchParameters(orientation: 'landscape', page: 2))This endpoint enables you to receive real-time photos curated by the Pexels team.
We add at least one new photo per hour to our curated list so that you always get a changing selection of trending photos.
$photos = $pexels->curatedPhotos();
// paginated
$photos = $pexels->curatedPhotos(new PaginationParameters(page: 2, per_page: 60));Retrieve a specific Photo from its id.
$photo = $pexels->photo(id: 11762029);This endpoint enables you to search Pexels for any topic 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.
$videos = $pexels->searchVideos('Tigers');
// landscape videos only
$videos = $pexels->searchVideos('Tigers', new SearchParameters(orientation: 'landscape', page: 2))This endpoint enables you to receive the current popular Pexels videos.
$videos = $pexels->popularVideos();
// 30 secondes popular videos
$videos = $pexels->popularVideos(new PopularVideosParameters(min_duration: 30, max_duration: 30));Retrieve a specific Video from its id.
$video = $pexels->video(id: 12593410);This endpoint returns all featured collections on Pexels.
$collections = $pexels->featuredCollections();
// paginated
$collections = $pexels->featuredCollection(new PaginationParameters(per_page: 80);This endpoint returns all of your collections.
$collections = $pexels->collections();This endpoint returns all the media (photos and videos) within a single collection. You can filter to only receive photos or videos using the type parameter.
$collection = $pexels->collection(id: 'someid');
// videos only
$collection = $pexels->collection(id: 'someid', new CollectionParameters(type: 'Videos'));Most Pexels API requests return multiple records at once. All of these endpoints are paginated, and can return a maximum of 80 requests at one time. Each paginated request accepts the same parameters and returns the same pagination data in the response.
Note: The prev_page and next_page response attributes will only be returned if there is a corresponding page.
