Brave Goggles Scraper

Discover public Brave Goggles or run Brave Search with a public Goggle applied. The Actor stores structured, deduplicated records in the default Apify dataset and validates that search pages confirm the requested Goggle.

Features

• list mode reads Brave's public Goggles catalog over HTTPS.
• search mode extracts organic results from Brave Search with a supplied Goggle.
• Hard record, page, retry, timeout, query, and URL limits.
• Stable URL deduplication and omission of empty optional fields.
• Optional Apify proxy configuration for targets that require it.

Input

Field	Type	Default	Description
mode	string	list	list or search.
query	string	—	Required in search mode; maximum 500 characters.
goggleUrl	string	—	Public HTTPS Goggle URL, required in search mode. Credentials, query strings, and fragments are removed before storage.
maxItems	integer	30	Maximum stored records in either mode, from 1 to 200.
maxPages	integer	5	Maximum search pages, from 1 to 20.
country	string	us	Two-letter Brave country code.
language	string	en	Brave language code.
maxRequestRetries	integer	3	Temporary-failure retries, from 0 to 10.
navigationTimeoutSecs	integer	60	Request/navigation timeout, from 10 to 180 seconds.
headless	boolean	true	Run Firefox headlessly in search mode.
proxyConfiguration	object	none	Standard Apify proxy editor value.

List example:

{ "mode": "list", "maxItems": 10 }

Search example:

{
  "mode": "search",
  "query": "artificial intelligence",
  "goggleUrl": "https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/tech_blogs.goggle",
  "maxItems": 10,
  "maxPages": 2,
  "country": "us",
  "language": "en"
}

Output

Every record includes type, position, resultType, title, link, goggleUrl, scrapedAt, and searchMetadata. Catalog records can also include author, description, popularity, digest, update time, homepage, and transfer metadata. Search records can include snippet text/HTML, domain, publisher, publication time, highlights, thumbnail, breadcrumbs, sitelinks, market, and Goggle context.

Example catalog record:

{
  "position": 1,
  "type": "goggle",
  "resultType": "goggle",
  "title": "Tech blogs",
  "link": "https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/tech_blogs.goggle",
  "goggleUrl": "https://raw.githubusercontent.com/brave/goggles-quickstart/main/goggles/tech_blogs.goggle",
  "isPublic": true,
  "scrapedAt": "2026-08-30T00:00:00.000Z",
  "searchMetadata": { "engine": "brave", "mode": "list", "resultType": "goggle" }
}

Limits, cost, and proxies

Runtime and cost grow with search pages and browser use. Start with a small maxItems and maxPages. Catalog mode usually does not need a proxy. Search mode can encounter rate limits or challenges; enable an authorized Apify proxy only when needed. The Actor never stores proxy credentials.

Troubleshooting

• A search input must contain both a non-empty query and a public HTTPS Goggle URL.
• If Brave does not confirm the Goggle, the Actor fails instead of returning ordinary, unranked results.
• Reduce page count, increase the timeout within the schema limit, or use an authorized proxy for repeated temporary failures.
• Empty optional fields are intentionally omitted rather than fabricated.

Related Actors

• Brave Autocomplete Scraper
• Brave AI Mode Scraper