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

CURL

POST /api/execute/go

curl -X POST \
 -H "Authorization: Bearer <token>" \
 -H "Content-Type: application/json" \
 -d '{
"url": "https://example.com"
}' \
http://localhost:8080/api/execute/go

Python SDK

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"
    )

Node.js SDK

import { OwlBrowser } from '@olib-ai/owl-browser-sdk';

// Async usage
const ctx = await browser.createContext();
const contextId = ctx.context_id;
await browser.go({
    url: 'https://example.com'
});

Parameters

Required

url string required

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

Optional

wait_until enum

• load, domcontentloaded, networkidle, fullscroll
  • 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)

timeout integer

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

output enum

• html, text, markdown, pngView, pngFull
  • Output format. Default: html

os enum

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

use_tor boolean

• 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>
}