browser_get_bounding_box

Browser Get Bounding Box

Get the position and size of an element. Returns {x, y, width, height} representing the element's bounding rectangle in viewport coordinates. Useful for positioning or calculating drag coordinates.

Usage Example

CURL

POST `/api/execute/browser_get_bounding_box`

curl -X POST \
 -H "Authorization: Bearer <token>" \
 -H "Content-Type: application/json" \
 -d '{
"context_id": "ctx_000001",
"selector": "#element-id"
}' \
http://localhost:8080/api/execute/browser_get_bounding_box

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.get_bounding_box(
        context_id=context_id,
        selector="#element-id"
    )

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.getBoundingBox({
    context_id: contextId,
    selector: '#element-id'
});

Parameters

Required

context_id string required

The unique identifier of the browser context (e.g., 'ctx_000001')

selector string required

CSS selector or natural language description of the element to get position and size for

Optional

index string

When multiple elements match the selector, get bounding box of the Nth element (0-based). Default: -1 (first match)

Response

Returns a JSON object with the operation result.

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