Struct PexelsClient 

pub struct PexelsClient { /* private fields */ }

Main client for the Pexels API

This client provides methods to interact with all endpoints of the Pexels API and handles authentication, request building and response parsing.

Implementations

impl PexelsClient

pub fn new<S: Into<String>>(api_key: S) -> Self

Creates a new PexelsClient with the provided API key

Arguments

• api_key - The Pexels API key

Returns

A new instance of PexelsClient

Example

use pexels_api::PexelsClient;

let client = PexelsClient::new("your_api_key");

pub fn with_config<S: Into<String>>( api_key: S, timeout: u64, max_idle_connections: usize, ) -> Self

Creates a new PexelsClient with custom configuration

Arguments

• api_key - The Pexels API key
• timeout - Request timeout in seconds
• max_idle_connections - Maximum number of idle connections per host

Returns

A new instance of PexelsClient

pub fn with_base_url<S: Into<String>>(self, base_url: S) -> Self

Sets a custom base URL for the Pexels API

Arguments

• base_url - The custom base URL

Returns

Self for method chaining

pub async fn search_photos( &self, query: &str, params: &SearchParams, ) -> Result<PhotosPage, PexelsError>

Search for photos matching the specified query and parameters

Arguments

• query - The search query
• params - Additional search parameters (pagination, filters, etc.)

Returns

A Result containing the photos search response or an error

Example

use pexels_api::{PexelsClient, SearchParams,Size};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = PexelsClient::new("your_api_key");
    let params = SearchParams::new()
        .page(1)
        .per_page(15)
        .size(Size::Large);

    let photos = client.search_photos("nature", &params).await?;
    println!("Found {} photos", photos.total_results);
    Ok(())
}

pub async fn curated_photos( &self, params: &PaginationParams, ) -> Result<PhotosPage, PexelsError>

Fetch curated/featured photos

Arguments

• params - Pagination parameters

Returns

A Result containing the curated photos response or an error

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

Get a specific photo by its ID

Arguments

• id - The photo ID

Returns

A Result containing the photo or an error

pub async fn search_videos( &self, query: &str, params: &VideoSearchParams, ) -> Result<VideosPage, PexelsError>

Search for videos matching the specified query and parameters

Arguments

• query - The search query
• params - Additional search parameters (pagination, filters, etc.)

Returns

A Result containing the videos search response or an error

pub async fn popular_videos( &self, params: &PaginationParams, ) -> Result<VideosPage, PexelsError>

Fetch popular videos

Arguments

• params - Pagination parameters

Returns

A Result containing the popular videos response or an error

pub async fn popular_videos_with_params( &self, params: &PopularVideoParams, ) -> Result<VideosPage, PexelsError>

Fetch popular videos with documented filters.

Arguments

• params - Pagination, size and duration filters

Returns

A Result containing the popular videos response or an error

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

Get a specific video by its ID

Arguments

• id - The video ID

Returns

A Result containing the video or an error

pub async fn get_collections( &self, params: &PaginationParams, ) -> Result<CollectionsPage, PexelsError>

Get collections list

Arguments

• params - Pagination parameters

Returns

A Result containing the collections response or an error

pub async fn get_featured_collections( &self, params: &PaginationParams, ) -> Result<CollectionsPage, PexelsError>

Get featured collections list

Arguments

• params - Pagination parameters

Returns

A Result containing the featured collections response or an error

pub async fn get_collection_media( &self, id: &str, params: &PaginationParams, ) -> Result<MediaPage, PexelsError>

Get collection media items (photos and videos)

Arguments

• id - The collection ID
• params - Pagination parameters

Returns

A Result containing the media response or an error

pub async fn get_collection_media_with_params( &self, id: &str, params: &CollectionMediaParams, ) -> Result<MediaPage, PexelsError>

Get collection media items (photos and videos) with documented filters

Arguments

• id - The collection ID
• params - Pagination, media type and sort filters

Returns

A Result containing the media response or an error