bravesearch

package module

Go to main page

Versions in this module

v0

v0.3.2

Jul 2, 2026

Changes in this version

+ var ErrInvalidEndpoint = errors.New("invalid endpoint")

+ var ErrResponseTooLarge = errors.New("response body too large")

v0.3.1

Jun 10, 2026

v0.3.0

Jun 4, 2026

Changes in this version

+ const MaxWebSearchCount

+ const MaxWebSearchOffset

type ClientConfig

+ WebSearchEndpoint string

type ClientOption

+ func WithWebSearchEndpoint(endpoint string) ClientOption

type Config

+ WebSearchEndpoint string

+ type RichHint struct

+ CallbackKey string

+ Vertical string

type RichResponse

+ Hint *RichHint

type WebSearchParams

+ EnableRichCallback bool

+ IncludeFetchMetadata bool

type WebSearchResponse

+ RateLimit *RateLimit

v0.2.0

Jan 12, 2026

Changes in this version

+ const BaseURL

+ const DefaultCount

+ const DefaultCountry

+ const DefaultMaxRetries

+ const DefaultOffset

+ const DefaultSafeSearch

+ const DefaultSearchLang

+ const DefaultSpellCheck

+ const DefaultTextDecor

+ const DefaultTimeout

+ const DefaultUILang

+ const DefaultUserAgent

+ const FreshnessDay

+ const FreshnessMonth

+ const FreshnessWeek

+ const FreshnessYear

+ const HeaderAccept

+ const HeaderAcceptEncoding

+ const HeaderCacheControl

+ const HeaderLocCity

+ const HeaderLocCountry

+ const HeaderLocLatitude

+ const HeaderLocLongitude

+ const HeaderLocPostalCode

+ const HeaderLocState

+ const HeaderLocStateName

+ const HeaderLocTimezone

+ const HeaderRateLimitLimit

+ const HeaderRateLimitPolicy

+ const HeaderRateLimitRemaining

+ const HeaderRateLimitReset

+ const HeaderSubscriptionToken

+ const HeaderUserAgent

+ const MIMETypeGzip

+ const MIMETypeJSON

+ const ResultFilterDiscussions

+ const ResultFilterFaq

+ const ResultFilterInfobox

+ const ResultFilterLocations

+ const ResultFilterNews

+ const ResultFilterQuery

+ const ResultFilterSummarizer

+ const ResultFilterVideos

+ const ResultFilterWeb

+ const SafeSearchModerate

+ const SafeSearchOff

+ const SafeSearchStrict

+ const UnitImperial

+ const UnitMetric

+ const UserAgentPrefix

+ const Version

+ const WebSearchEndpoint

+ var ErrEmptyQuery = errors.New("query cannot be empty")

+ var ErrForbidden = errors.New("forbidden")

+ var ErrInvalidAPIKey = errors.New("invalid API key")

+ var ErrInvalidParameters = errors.New("invalid parameters")

+ var ErrInvalidResponse = errors.New("invalid response")

+ var ErrMissingAPIKey = errors.New("missing API key")

+ var ErrNotFound = errors.New("not found")

+ var ErrQueryTooLong = errors.New("query too long (max 400 chars or 50 words)")

+ var ErrRateLimit = errors.New("rate limit exceeded")

+ var ErrServerError = errors.New("server error")

+ var ErrSubscriptionTokenInvalid = errors.New("invalid subscription token")

+ var ErrUnauthorized = errors.New("unauthorized")

+ var ErrUnprocessableEntity = errors.New("unprocessable entity")

+ func GetUserAgent() string

+ func GetVersion() string

+ func IsAuthError(err error) bool

+ func IsRateLimitError(err error) bool

+ func IsServerError(err error) bool

+ func IsUnprocessableEntity(err error) bool

+ func ValidateConfig(config *ClientConfig) error

+ type APIError struct

+ Err error

+ Message string

+ StatusCode int

+ func NewAPIError(statusCode int, message string, err error) *APIError

+ func NewHTTPError(resp *http.Response) *APIError

+ func (e *APIError) Error() string

+ func (e *APIError) Unwrap() error

+ type ButtonResult struct

+ Title string

+ Type string

+ URL string

+ type Client struct

+ func NewClient(apiKey string, options ...ClientOption) (*Client, error)

+ func (c *Client) WebSearch(ctx context.Context, query string, params *WebSearchParams) (*WebSearchResponse, error)

+ func (c *Client) WebSearchNews(ctx context.Context, query string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchRecent(ctx context.Context, query string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchSummary(ctx context.Context, query string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchVideos(ctx context.Context, query string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithCountry(ctx context.Context, query string, country string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithFreshness(ctx context.Context, query string, freshness string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithGoggles(ctx context.Context, query string, goggles string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithGogglesID(ctx context.Context, query string, gogglesID string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithLanguage(ctx context.Context, query string, lang string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithPagination(ctx context.Context, query string, count, offset int) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithSafeSearch(ctx context.Context, query string, safeSearch string) (*WebSearchResponse, error)

+ func (c *Client) WebSearchWithUnits(ctx context.Context, query string, units string) (*WebSearchResponse, error)

+ type ClientConfig struct

+ APIKey string

+ BaseURL string

+ DefaultCountry string

+ DefaultSearchLang string

+ DefaultUILang string

+ HTTPClient *http.Client

+ MaxRetries int

+ Timeout time.Duration

+ UserAgent string

+ type ClientOption func(*ClientConfig) error

+ func WithBaseURL(baseURL string) ClientOption

+ func WithConfig(config *Config) ClientOption

+ func WithDefaultCountry(country string) ClientOption

+ func WithDefaultSearchLanguage(lang string) ClientOption

+ func WithDefaultUILanguage(lang string) ClientOption

+ func WithHTTPClient(client *http.Client) ClientOption

+ func WithRetries(retries int) ClientOption

+ func WithTimeout(seconds int) ClientOption

+ func WithUserAgent(userAgent string) ClientOption

+ type Config struct

+ APIKey string

+ BaseURL string

+ DefaultCountry string

+ DefaultSearchLang string

+ DefaultUILang string

+ HTTPClient *http.Client

+ MaxRetries int

+ Timeout time.Duration

+ UserAgent string

+ func NewDefaultConfig() *Config

+ type DeepResults struct

+ Buttons []ButtonResult

+ Images []ImageResult

+ News []NewsResult

+ Social []SocialResult

+ Video []VideoResult

+ type DiscussionResult struct

+ Age string

+ Description string

+ FamilyFriendly bool

+ Language string

+ PageAge string

+ Profile *Profile

+ Title string

+ Type string

+ URL string

+ type Discussions struct

+ Results []DiscussionResult

+ Type string

+ type FAQ struct

+ Results []FAQResult

+ Type string

+ type FAQResult struct

+ Answer string

+ Question string

+ Type string

+ type GraphInfobox struct

+ Data *InfoboxData

+ Type string

+ type ImageResult struct

+ Height int

+ Source string

+ Thumbnail *Thumbnail

+ Title string

+ Type string

+ URL string

+ Width int

+ type InfoboxData struct

+ Attributes [][]string

+ Description string

+ Label string

+ Profiles []Profile

+ Thumbnail *Thumbnail

+ Title string

+ URL string

+ type LocationPOI struct

+ Address string

+ ID string

+ Name string

+ Phone string

+ Rating float64

+ ReviewCount int

+ Thumbnail *Thumbnail

+ Type string

+ URL string

+ type Locations struct

+ Results []LocationPOI

+ Type string

+ type MetaURL struct

+ Favicon string

+ Hostname string

+ Netloc string

+ Path string

+ Scheme string

+ type MixedResponse struct

+ Main []MixedResultRef

+ Side []MixedResultRef

+ Top []MixedResultRef

+ Type string

+ type MixedResultRef struct

+ All bool

+ Index int

+ Type string

+ type News struct

+ Results []NewsResult

+ Type string

+ type NewsResult struct

+ Age string

+ Description string

+ FamilyFriendly bool

+ Language string

+ PageAge string

+ Profile *Profile

+ Thumbnail *Thumbnail

+ Title string

+ Type string

+ URL string

+ type Profile struct

+ Img string

+ LongName string

+ Name string

+ URL string

+ type Query struct

+ Altered string

+ BadResults bool

+ City string

+ Country string

+ HeaderCountry string

+ IsNavigational bool

+ IsNewsBreaking bool

+ MoreResultsAvailable bool

+ Original string

+ PostalCode string

+ ShouldFallback bool

+ ShowStrictWarning bool

+ SpellcheckOff bool

+ State string

+ type RateLimit struct

+ Limit int

+ Remaining int

+ Reset int

+ type RichResponse struct

+ Result any

+ Type string

+ type Search struct

+ FamilyFriendly bool

+ Results []SearchResult

+ Type string

+ type SearchResult struct

+ Age string

+ ContentType string

+ DeepResults *DeepResults

+ Description string

+ ExtraSnippets []string

+ FamilyFriendly bool

+ IsLive bool

+ IsSourceBoth bool

+ IsSourceLocal bool

+ Language string

+ MetaURL *MetaURL

+ PageAge string

+ PageFetched string

+ Profile *Profile

+ Subtype string

+ Thumbnail *Thumbnail

+ Title string

+ Type string

+ URL string

+ type SocialResult struct

+ Profile string

+ Snippet string

+ Title string

+ Type string

+ URL string

+ type Summarizer struct

+ Key string

+ Status string

+ Type string

+ type Thumbnail struct

+ Logo bool

+ Original string

+ Src string

+ type VideoResult struct

+ Age string

+ Description string

+ Duration string

+ EmbedURL string

+ FamilyFriendly bool

+ Language string

+ PageAge string

+ Thumbnail *Thumbnail

+ Title string

+ Type string

+ URL string

+ type Videos struct

+ Results []VideoResult

+ Type string

+ type WebSearchParams struct

+ Count int

+ Country string

+ ExtraSnippets bool

+ Freshness string

+ Goggles string

+ GogglesID string

+ Offset int

+ Query string

+ ResultFilter string

+ SafeSearch string

+ SearchLang string

+ Spellcheck bool

+ Summary bool

+ TextDecorations bool

+ UILang string

+ Units string

+ func NewWebSearchParams() *WebSearchParams

+ type WebSearchResponse struct

+ Discussions *Discussions

+ FAQ *FAQ

+ Infobox *GraphInfobox

+ Locations *Locations

+ Mixed *MixedResponse

+ News *News

+ Query *Query

+ Rich *RichResponse

+ Summarizer *Summarizer

+ Type string

+ Videos *Videos

+ Web *Search

+ func (r *WebSearchResponse) GetFirstResult() *SearchResult

+ func (r *WebSearchResponse) GetResultCount() int

+ func (r *WebSearchResponse) GetWebResults() []SearchResult

+ func (r *WebSearchResponse) HasMoreResults() bool

+ func (r *WebSearchResponse) IsWebResultEmpty() bool

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL