Struct SearchService

Source

pub struct SearchService {
    http_client: SerperHttpClient,
}

Expand description

Main search service for the Serper SDK

This service provides the primary interface for search operations, combining query building, HTTP client management, and response processing.

Fields§

§http_client: SerperHttpClient

Implementations§

Source §

impl SearchService

Source

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

Creates a new search service with the specified API key

§Arguments

api_key - The Serper API key

§Returns

Result containing the search service or an error

Source

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

Creates a new search service 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 search service or an error

Source

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

Performs a search with the given query

§Arguments

query - The search query to execute

§Returns

Result containing the search response or an error

Source

pub async fn search_simple(&self, query_string: &str) -> Result<SearchResponse>

Performs a search with a simple query string

§Arguments

query_string - The search query string

§Returns

Result containing the search response or an error

Source

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

Performs multiple searches in sequence

§Arguments

queries - The search queries to execute

§Returns

Result containing a vector of search responses or an error

Source

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

Performs multiple searches concurrently

§Arguments

queries - The search queries to execute
max_concurrent - Maximum number of concurrent requests (default: 5)

§Returns

Result containing a vector of search responses or an error

Source

pub fn query_builder(&self) -> SearchQueryBuilder

Creates a new query builder

§Returns

A SearchQueryBuilder instance for fluent query construction

Source

pub async fn search_with<F>(&self, builder_fn: F) -> Result<SearchResponse>
where F: FnOnce(SearchQueryBuilder) -> SearchQueryBuilder,

Searches with query builder pattern

§Arguments

builder_fn - Function to configure the query builder

§Returns

Result containing the search response or an error

§Example

use serper_sdk::{SearchService, SearchQueryBuilder};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let _service = SearchService::new("demo-key-for-docs".to_string())?;
     
    // Demonstrate the builder pattern structure
    let query = SearchQueryBuilder::new()
        .query("Hamze Ghalebi CTO at Remolab")
        .location("Paris")
        .page(1)
        .build()?;
     
    println!("Query built with search_with pattern: {}", query.q);
    // In real async usage: service.search_with(|builder| { ... }).await?
    Ok(())
}