Struct Pexels

Source

pub struct Pexels { /* private fields */ }

Expand description

Client for interacting with the Pexels API

§Example

use dotenv::dotenv;
use pexels_api::Pexels;
use std::env;

#[tokio::main]
async fn main() {
   dotenv().ok();
  let api_key = env::var("PEXELS_API_KEY").expect("PEXELS_API_KEY not set");
 let client = Pexels::new(api_key);
}

§Errors

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

§Example

use dotenv::dotenv;
use pexels_api::Pexels;
use pexels_api::SearchBuilder;
use std::env;

#[tokio::main]
async fn main() {
    dotenv().ok();
    let api_key = env::var("PEXELS_API_KEY").expect("PEXELS_API_KEY not set");
    let client = Pexels::new(api_key);
    let response = client.search_photos(SearchBuilder::new().query("mountains").per_page(15).page(1)).await.expect("Failed to get photos");
    println!("{:?}", response);
}

Implementations§

Source §

impl Pexels

Source

pub fn new(api_key: String) -> Self

Create a new Pexels client.

Source

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.

Source

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.

Source

pub async fn curated_photo( &self, builder: CuratedBuilder, ) -> Result<PhotosResponse, PexelsError>

Retrieves a random photo from the Pexels API.

§Arguments

builder - A CuratedBuilder instance with the search parameters.

§Errors

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

Source

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.

Source

pub async fn popular_videos( &self, builder: PopularBuilder, ) -> Result<VideoResponse, PexelsError>

popular_videos Retrieves a list of popular videos from the Pexels API.

§Arguments

builder - A PopularBuilder instance with the search parameters.

§Errors

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

Source

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.

Source

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.

Source

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

featured_collections Retrieves a list of featured 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.

§Example

use dotenv::dotenv;
use pexels_api::Pexels;
use std::env;

#[tokio::main]
async fn main() {
    dotenv().ok();
    let api_key = env::var("PEXELS_API_KEY").expect("PEXELS_API_KEY not set");
    let client = Pexels::new(api_key);
    let response = client.featured_collections(15, 1).await.expect("Failed to get collections");
    println!("{:?}", response);
}