Struct SearchQuery

pub struct SearchQuery {
    pub q: String,
    pub location: Option<String>,
    pub gl: Option<String>,
    pub hl: Option<String>,
    pub page: Option<u32>,
    pub num: Option<u32>,
}

Represents a search query with all possible parameters

This struct encapsulates all the parameters that can be sent to the Serper API for search requests, with optional fields for flexible query construction.

Fields

q: String

The search query string (required)

location: Option<String>

Optional location specification

gl: Option<String>

Optional country code (gl parameter)

hl: Option<String>

Optional language code (hl parameter)

page: Option<u32>

Optional page number for pagination

num: Option<u32>

Optional number of results per page

Implementations

impl SearchQuery

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

Creates a new search query with the specified query string

Arguments

• query - The search query string

Returns

A Result containing the SearchQuery or an error if validation fails

pub fn with_location(self, location: String) -> Self

Sets the location for the search query

Arguments

• location - The location string (e.g., “Paris, France”)

pub fn with_country(self, country: String) -> Self

Sets the country code for the search query

Arguments

• country - The country code (e.g., “fr”, “us”)

pub fn with_language(self, language: String) -> Self

Sets the language code for the search query

Arguments

• language - The language code (e.g., “en”, “fr”)

pub fn with_page(self, page: u32) -> Self

Sets the page number for pagination

Arguments

• page - The page number (1-based)

pub fn with_num_results(self, num: u32) -> Self

Sets the number of results per page

Arguments

• num - The number of results (typically 1-100)

pub fn with_location_config(self, location: Location) -> Self

Applies location settings from a Location struct

Arguments

• location - The location configuration

pub fn with_pagination(self, pagination: Pagination) -> Self

Applies pagination settings from a Pagination struct

Arguments

• pagination - The pagination configuration

pub fn validate(&self) -> Result<()>

Validates the search query parameters

Returns

Result indicating whether the query is valid

pub fn query(&self) -> &str

Gets the query string

pub fn has_location_params(&self) -> bool

Checks if the query has location parameters

pub fn has_pagination_params(&self) -> bool

Checks if the query has pagination parameters

Trait Implementations

impl Clone for SearchQuery

fn clone(&self) -> SearchQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SearchQuery

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SearchQuery

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SearchQuery

fn eq(&self, other: &SearchQuery) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SearchQuery

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SearchQuery