---
title: "browser_search: One-shot web search tool | Owl Browser"
description: "One-shot web search tool. POST /execute/browser_search: parameters and runnable curl, Node.js and Python examples."
canonical: https://owlbrowser.net/docs/browser_search/
---
Find a tool

[Navigation](https://owlbrowser.net/docs/#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_search no context needed 5 parameters, 1 required

## Parameters

*JSON body fields*

| 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: duckduckgo One 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](https://owlbrowser.net/docs/#quick-start). SDK guides: [Node.js](https://owlbrowser.net/node-sdk/), [Python](https://owlbrowser.net/python-sdk/).

```bash
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

```bash
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](https://owlbrowser.net/docs/#responses).

browser_search result

```json
{
  "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.
