Struct Pexels

pub struct Pexels { /* private fields */ }

Client for interacting with the Pexels API

Implementations

impl Pexels

pub fn new(api_key: String) -> Self

Create a new Pexels client.

pub async fn search_photos( &self, builder: SearchBuilder<'_>, ) -> Result<PhotosResponse, PexelsError>

Retrieves a list of photos from the Pexels API based on the search criteria.

Arguments

• builder - A SearchBuilder instance with the search parameters.

Errors

Returns a PexelsError if the request fails or the response cannot be parsed as JSON.

pub async fn get_photo(&self, id: usize) -> Result<Photo, PexelsError>

Retrieves a photo by its ID from the Pexels API.

Arguments

• id - The ID of the photo to retrieve.

Errors

Returns a PexelsError if the request fails or the response cannot be parsed as JSON.

pub async fn search_videos( &self, builder: VideoSearchBuilder<'_>, ) -> Result<VideoResponse, PexelsError>

Retrieves a list of videos from the Pexels API based on the search criteria.

Arguments

• builder - A VideoSearchBuilder instance with the search parameters.

Errors

Returns a PexelsError if the request fails or the response cannot be parsed as JSON.

pub async fn get_video(&self, id: usize) -> Result<Video, PexelsError>

Retrieves a video by its ID from the Pexels API.

Arguments

• id - The ID of the video to retrieve.

Errors

Returns a PexelsError if the request fails or the response cannot be parsed as JSON.

pub async fn search_collections( &self, per_page: usize, page: usize, ) -> Result<CollectionsResponse, PexelsError>

Retrieves a list of collections from the Pexels API.

Arguments

• per_page - The number of collections to retrieve per page.
• page - The page number to retrieve.

Errors

Returns a PexelsError if the request fails or the response cannot be parsed as JSON.

pub async fn search_media( &self, builder: MediaBuilder, ) -> Result<MediaResponse, PexelsError>

Retrieves all media (photos and videos) within a single collection.

Arguments

• builder - A MediaBuilder instance with the search parameters.

Errors

Returns a PexelsError if the request fails or the response cannot be parsed as JSON.