serper

package

v0.45.0 Latest Latest Go to latest Published: Oct 8, 2026 License: Apache-2.0 Imports: 9 Imported by: 0

Details

Package serper wires Serper's Google Search API into web.Searcher.

Requests use POST /search with the X-API-KEY header and always enable autocorrect.

web.SearchRequest maps to the Serper request:

Query → q, with domain filters rewritten by web.SearchRequest.QueryWithSiteOperators
MaxResults → num (omitted when unset)
Recency → tbs=qdr:h|d|w|m|y

Only organic[] results are surfaced: title → Title, link → URL, snippet → Snippet, and date → PublishedTime when it is an absolute date.

This section is empty.

This section is empty.

This section is empty.

type Client struct {
	// contains filtered or unexported fields
}

Client implements web.Searcher against the Serper Google Search API.

func NewClient(config Config) (*Client, error)

func (c *Client) Search(ctx context.Context, request *web.SearchRequest) (*web.SearchResponse, error)

type Config struct {
	APIKey     string
	BaseURL    string
	HTTPClient *http.Client
}

Config configures a Client. APIKey is required; an empty BaseURL selects Serper's public endpoint and a nil HTTPClient selects a default client.