Struct SerperHttpClient

pub struct SerperHttpClient {
    transport: HttpTransport,
    api_key: ApiKey,
    base_url: BaseUrl,
}

High-level HTTP client for Serper API operations

This client handles authentication, request formatting, response parsing, and error handling for all Serper API interactions.

Fields

transport: HttpTransport

api_key: ApiKey

base_url: BaseUrl

Implementations

impl SerperHttpClient

pub fn new(api_key: ApiKey) -> Result<Self>

Creates a new HTTP client with the specified API key

Arguments

• api_key - The Serper API key

Returns

Result containing the HTTP client or an error

pub fn with_config( api_key: ApiKey, base_url: BaseUrl, config: TransportConfig, ) -> Result<Self>

Creates a new HTTP client with custom configuration

Arguments

• api_key - The Serper API key
• base_url - Custom base URL for the API
• config - Transport configuration

Returns

Result containing the HTTP client or an error

pub async fn search(&self, query: &SearchQuery) -> Result<SearchResponse>

Executes a search query

Arguments

• query - The search query to execute

Returns

Result containing the search response or an error

pub async fn search_multiple( &self, queries: &[SearchQuery], ) -> Result<Vec<SearchResponse>>

Executes multiple search queries in sequence

Arguments

• queries - The search queries to execute

Returns

Result containing a vector of search responses or an error

pub async fn search_concurrent( &self, queries: &[SearchQuery], max_concurrent: usize, ) -> Result<Vec<SearchResponse>>

Executes multiple search queries concurrently

Arguments

• queries - The search queries to execute
• max_concurrent - Maximum number of concurrent requests

Returns

Result containing a vector of search responses or an error

pub fn api_key(&self) -> &ApiKey

Gets the API key (for debugging/logging purposes)

pub fn base_url(&self) -> &BaseUrl

Gets the base URL

pub fn transport_config(&self) -> &TransportConfig

Gets the transport configuration

fn clone_for_concurrent(&self) -> Self

Helper method to clone the client for concurrent operations

This creates a new HTTP transport but reuses the API key and base URL

Trait Implementations

impl Debug for SerperHttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.