browser_search
One-shot web search tool.
Creates a new context, navigates to the search engine, waits for results, extracts structured JSON search results (titles, URLs, snippets), and closes the context. Supports Google and DuckDuckGo with pagination.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | required | The search query string (e.g., 'best restaurants in NYC', 'python tutorial') |
provider | string | optional | Search engine provider. 'duckduckgo' uses DuckDuckGo HTML-lite, 'google' uses Google Search. Default: duckduckgoOne of: duckduckgo, google |
page | integer | optional | Page number for paginated results (1-based). Default: 1. For Google: appends &start=((page-1)*10). For DuckDuckGo: appends &s=((page-1)*10) |
os | string | optional | Filter profiles by operating system. Options: 'windows', 'macos', 'linux'One of: windows, macos, linux |
use_tor | boolean | optional | Use TOR proxy for anonymous browsing. Each request gets a unique exit IP. Default: false |
Request
POST /execute/browser_search (/api/execute/browser_search via the container). No browser context is needed. Setup: quick start. SDK guides: Node.js, Python.
curl -s -X POST "$OWL_URL/execute/browser_search" -H "$AUTH" -H "$JSON" \
-d '{"query":"open source web browsers"}'; echo
const result = await browser.search({ query: 'open source web browsers' });
result = await browser.search(query="open source web browsers")
Complete curl, Node.js, Python scripts run as written on 2026-11-17 (Owl Browser 1.4.1, SDK 2.3.0, local origin).
Also available as GET /search
/search runs the same server handler as /execute/browser_search, with the parameters in the query string (it also accepts a POST with a JSON body). The server describes it as: “One-shot web search. Creates context, navigates to search engine, extracts structured JSON results, closes context.” The query parameters are the ones listed above.
curl -s -G "$OWL_URL/search" -H "$AUTH" \
--data-urlencode 'query=open source web browsers'
Response
Captured from Owl Browser 1.4.1; REST wraps it in the success envelope.
{
"template": "duckduckgo_search",
"version": "1.0.0",
"data": {
"query": "open source web browsers",
"results": [
{
"title": "11 Best Open Source Web Browsers [Must-Know Alternatives]",
"url": "https://alvarotrigo.com/blog/open-source-web-browsers/",
"snippet": "What is an Open-source Web Browser? An open-source web browser is released under an open source license, in contrast to proprietary browsers, which are close...",
"displayed_url": "alvarotrigo.com/blog/open-source-web-browsers/"
},
{
"title": "Best Open-Source Browsers in 2026",
"url": "https://browsers.to/articles/best-open-source-browsers",
"snippet": "Compare the best open-source browsers in 2026. Find transparent, auditable browsers with stronger privacy and no vendor lock-in. Fully ranked and reviewed.",
"displayed_url": "browsers.to/articles/best-open-source-browsers"
},
{
"title": "Open Source Web Browsers",
"url": "https://www.opensourcealternatives.to/collection/open-source-web-browsers",
"snippet": "Explore the best free open source web browsers that are powerful alternatives to Arc Browser, Google Chrome, Firefox, Opera, and others for secure browsing.",
"displayed_url": "www.opensourcealternatives.to/collection/open-source-web-browsers"
},
{
"title": "web-browser · GitHub Topics · GitHub",
"url": "https://github.com/topics/web-browser",
"snippet": "GitHub is where people build software. More than 225 million people use GitHub to discover, fork, and contribute to over 800 million projects.",
"displayed_url": "github.com/topics/web-browser"
},
{
"title": "Best Open Source Browsers 2026",
"url": "https://sourceforge.net/directory/browsers/",
"snippet": "Chromium is the open‑source foundational web browser project that drives browsers like Google Chrome, Microsoft Edge, and Opera—built for speed, stability, s...",
"displayed_url": "sourceforge.net/directory/browsers/"
},
"... 5 more"
],
"next_page_offset": 10,
"vqd_token": "4-3753343413203244720090912553903739021"
}
}Long strings and arrays are shortened. Values differ per run and per page.