Brave Goggles Scraper

Discovers available Brave Goggles, applies custom re-ranking filters to search results, and extracts the re-ranked organic results. Goggles are community-developed ranking rules that boost/demote specific sources.

What this Actor collects

In list mode, each item describes one public Brave Goggle. In search mode, each item is one organic result ranked with the supplied Goggle and includes the applied-Goggle context.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 45-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Discovering public Brave ranking rules
• Comparing Goggle-ranked search visibility
• Source curation and ranking research

Input

Provide input in JSON. Fields marked required must be supplied; source-specific alternatives and constraints are described in the field text.

Field	Type	Required	Default	Description
mode	string	Yes	"list"	Whether to list available Goggles or apply a Goggle to search results.
query	string	No	—	The search query to use when mode is search.
goggleUrl	string	No	—	URL of the Goggle to apply (for example, a raw GitHub Goggle file). Required when mode is search.
maxItems	integer	No	30	Maximum number of search results to scrape when using 'search' mode.
maxPages	integer	No	5	Maximum Brave result pages to inspect in search mode.
country	string	No	"us"	Brave country code for localized results.
language	string	No	"en"	Brave language code.
maxRequestRetries	integer	No	3	Retries for temporary API, navigation, rate-limit, and browser failures.
navigationTimeoutSecs	integer	No	60	Maximum time for API requests and browser navigation.
headless	boolean	No	true	Run Firefox without a visible window in search mode.
proxyConfiguration	object	No	—	Proxy settings for the scraper.

Example input

{
  "mode": "search",
  "query": "artificial intelligence",
  "maxItems": 10,
  "maxPages": 3,
  "country": "us",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "goggleUrl": "https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/tech_blogs.goggle",
  "maxRequestRetries": 3,
  "navigationTimeoutSecs": 60
}

Output

The default dataset contains either public-Goggle records or Goggle-ranked search results, depending on mode. The following fields cover both record types; availability varies accordingly.

Field	Type	Description
position	integer	Position
title	string	Title
link	string	URL
snippet	string	Snippet
domain	string	Domain
goggleName	string	Goggle Name
resultType	string	Result Type
isGoggleApplied	boolean	Goggle Applied
lastUpdate	string	Last Update
type	string	Record Type
source	string	Source
searchQuery	string	Search Query
scrapedAt	string	Scraped At
page	integer	Page
titleHtml	string	Title HTML
displayUrl	string	Displayed URL

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "position": 1,
  "title": "Tech blogs",
  "link": "https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/tech_blogs.goggle",
  "goggleName": "Tech blogs",
  "resultType": "goggle",
  "lastUpdate": "2026-07-21T15:35:36.349Z",
  "type": "goggle",
  "scrapedAt": "2026-07-23T15:35:42.752Z",
  "isGoggle": true,
  "goggleDescription": "Rerank results to boost content on tech blogs. List of tech blogs drawn from several sources (blogsurf.io, refined.blog, et al), and not vetted or endorsed by Brave.",
  "goggleAuthor": "Goggles 101",
  "goggleId": "https%3A%2F%2Fraw.githubusercontent.com%2Fbrave%2Fgoggles-quickstart%2Fmain%2Fgoggles%2Ftech_blogs.goggle"
}

Related Actors

• Brave AI Mode Scraper
• Brave Autocomplete Scraper
• Brave Discussions Scraper