Navigation

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.

POST /execute/browser_searchno context needed5 parameters, 1 required

Parameters

JSON body fields
NameTypeRequiredDescription
querystringrequiredThe search query string (e.g., 'best restaurants in NYC', 'python tutorial')
providerstringoptionalSearch engine provider. 'duckduckgo' uses DuckDuckGo HTML-lite, 'google' uses Google Search. Default: duckduckgoOne of: duckduckgo, google
pageintegeroptionalPage number for paginated results (1-based). Default: 1. For Google: appends &start=((page-1)*10). For DuckDuckGo: appends &s=((page-1)*10)
osstringoptionalFilter profiles by operating system. Options: 'windows', 'macos', 'linux'One of: windows, macos, linux
use_torbooleanoptionalUse 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

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.

GET /search with curl
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.

browser_search result
{
  "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.