DocsElement Statebrowser_get_element_at_position

browser_get_element_at_position

browser_get_element_at_position

Get detailed information about the DOM element at specific XY coordinates. Returns element tag, ID, classes, bounding box, text content, and computed styles. Use with browser_show_grid_overlay to find coordinates. Useful for debugging and building element picker UIs.

When to use browser_get_element_at_position

Use browser_get_element_at_position when you need to inspect the state, attributes, and geometry of page elements. It is part of Owl Browser's Element State toolset and runs inside a self-hosted, source-level stealth engine, so every call inherits the same undetectable browser fingerprint as the rest of your automation — no separate anti-detect setup required.

Usage Example

12345678910111213
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_element_at_position(
context_id=context_id,
x=0,
y=0
)

Parameters

Required

context_idstringrequired

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

xnumberrequired

X coordinate in pixels from the left edge of the viewport. Use browser_show_grid_overlay to visualize coordinates on the page

ynumberrequired

Y coordinate in pixels from the top edge of the viewport. Use browser_show_grid_overlay to visualize coordinates on the page

Response

Returns a JSON object with the operation result.

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

Frequently Asked Questions

What does browser_get_element_at_position do?

Get detailed information about the DOM element at specific XY coordinates. Returns element tag, ID, classes, bounding box, text content, and computed styles. Use with browser_show_grid_overlay to find coordinates. Useful for debugging and building element picker UIs. It belongs to Owl Browser's Element State category and is available through the REST API, the Python SDK (browser.get_element_at_position()), the Node.js SDK, and the MCP server.

What parameters does browser_get_element_at_position accept?

browser_get_element_at_position accepts 3 required parameters (context_id, x, y) and 0 optional parameters. All parameters are sent as JSON in a POST request to /api/execute/browser_get_element_at_position.

Is browser_get_element_at_position detectable by anti-bot systems like Cloudflare or DataDome?

No. browser_get_element_at_position executes inside Owl Browser's Chromium engine, which applies fingerprint spoofing at the C++ source level rather than through JavaScript patches. Every tool call shares the same consistent, human-like fingerprint, so anti-bot systems such as Cloudflare, DataDome, and Akamai see an ordinary browser.

Related Tools

Browse the full Owl Browser API reference or get started with the Python SDK and Node.js SDK.