This is an Encore package for searching and retrieving photos and videos from Pexels.
- Copy over the
pexelspackage directory to your Encore application. - Sync your project dependencies by running
go mod tidy.
You will need an API key from Pexels to use this package. You can get one by signing up for a free account at https://www.pexels.com/.
Once you have the API key, set it as an Encore secret using the name PexelsApiKey:
$ encore secret set --type dev,prod,local,pr PexelsApiKey
Enter secret value: *****
Successfully updated development secret PexelsApiKey.The pexels package contains the following endpoints:
-
pexels.SearchPhotos- Search Pexels for photos. -
pexels.CuratedPhotos- Receive real-time photos curated by the Pexels team. -
pexels.GetPhoto- Retrieve a specific photo. -
pexels.SearchVideos- Search Pexels for videos. -
pexels.PopularVideos- Retrieve the current popular Pexels videos. -
pexels.GetVideo- Retrieve a specific video. -
pexels.FeaturedCollections- Retrieve all featured collections on Pexels. -
pexels.MyCollections- Returns all of your collections. -
pexels.CollectionMedia- Returns all the media (photos and videos) within a single collection.
After generating a request client for your frontend you can call the endpoints like this:
// Making request to locally running backend...
const client = new Client(Local);
// or to a specific deployed environment
const client = new Client(Environment("staging"));
const resp = await client.pexels.SearchPhotos({
Query: "cats",
Page: 1,
PerPage: 15,
Color: "",
Locale: "",
Size: "",
Orientation: "",
});
console.log(resp.total_results);
console.log(resp.photos);