DocsNavigationgo

go

Browser Go

One-shot browser navigation tool. Creates a new context, navigates to the URL, waits for page load, extracts the HTML, and closes the context. Optimized for single-page scraping or rendering tasks. Supports both GET and POST requests.

Usage Example

1234567891011

import asyncio

from owl_browser import OwlBrowser, RemoteConfig

# Async usage

async with OwlBrowser(config) as browser:

context = await browser.create_context()

context_id = context["context_id"]

await browser.go(

url="https://example.com"

)

Parameters

Required

urlstringrequired

The full URL to navigate to, including protocol (e.g., 'https://example.com'). Supports http://, https://, file://, and data: URLs

Optional

wait_untilenum

loaddomcontentloadednetworkidle+1 more

When to consider navigation complete: '' (return immediately), 'load' (wait for load event), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle, default), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)

timeoutinteger

Maximum time to wait for navigation in milliseconds. Default: 30000 (30 seconds)

outputenum

htmltextmarkdownpngView+1 more

Output format. html=raw HTML, text=extracted text, markdown=markdown conversion, pngView=viewport screenshot as PNG image, pngFull=fullpage screenshot as PNG image. Default: html

osenum

windowsmacoslinux

Filter profiles by operating system. Options: 'windows', 'macos', 'linux'

use_torboolean

Use TOR proxy for anonymous browsing. Each request gets a unique exit IP. Default: false

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}