Browser Run /accessibilityTree endpoint launched

Browser Run now supports a standalone /accessibilityTree endpoint, giving agent and automation workflows direct access to the browser's accessibility tree for a rendered webpage.

An accessibility tree is the browser's structured view of a rendered page: roles, names, states, values, and hierarchy. It is useful for accessibility tooling, but also for AI agents and automation workflows that need page structure without the noise of raw HTML or the cost of screenshots.

For AI agents, this means less inference from pixels and less parsing HTML. You can provide the page structure directly, helping agents identify available elements and determine which actions they can take.

With the new /accessibilityTree endpoint, you can request the accessibility tree directly when you only need the semantic structure of a page. If you need multiple page formats in a single API call, you can use the /snapshot endpoint, which also returns Markdown, HTML, and screenshots.

<div><div><span>curl</span><span> </span><span>-X</span><span> </span><span>POST</span><span> </span><span>'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-run/accessibilityTree'</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>-H</span><span> </span><span>'Authorization: Bearer <apiToken>'</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>-H</span><span> </span><span>'Content-Type: application/json'</span><span> </span><span>\</span></div></div><div><div><span>  </span><span>-d</span><span> </span><span>'{</span></div></div><div><div><span><span>    </span></span><span>"url": "https://example.com/"</span></div></div><div><div><span>}'</span></div></div>

<div><div><span>{</span></div></div><div><div><span>  </span><span>"</span><span>success</span><span>"</span><span>:</span><span> </span><span>true</span><span>,</span></div></div><div><div><span>  </span><span>"</span><span>result</span><span>"</span><span>:</span><span> </span><span>{</span></div></div><div><div><span>    </span><span>"</span><span>accessibilityTree</span><span>"</span><span>:</span><span> </span><span>{</span></div></div><div><div><span>      </span><span>"</span><span>role</span><span>"</span><span>:</span><span> </span><span>"RootWebArea"</span><span>,</span></div></div><div><div><span>      </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"Example Domain"</span><span>,</span></div></div><div><div><span>      </span><span>"</span><span>children</span><span>"</span><span>:</span><span> </span><span>[</span></div></div><div><div><span>        </span><span>{</span></div></div><div><div><span>          </span><span>"</span><span>role</span><span>"</span><span>:</span><span> </span><span>"heading"</span><span>,</span></div></div><div><div><span>          </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"Example Domain"</span><span>,</span></div></div><div><div><span>          </span><span>"</span><span>level</span><span>"</span><span>:</span><span> </span><span>1</span></div></div><div><div><span>        </span><span>},</span></div></div><div><div><span>        </span><span>{</span></div></div><div><div><span>          </span><span>"</span><span>role</span><span>"</span><span>:</span><span> </span><span>"link"</span><span>,</span></div></div><div><div><span>          </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"Learn more"</span></div></div><div><div><span>        </span><span>}</span></div></div><div><div><span>      </span><span>]</span></div></div><div><div><span>    </span><span>}</span></div></div><div><div><span>  </span><span>}</span></div></div><div><div><span>}</span></div></div>

Use interestingOnly to return only semantically meaningful nodes, or root to capture the accessibility tree for a specific subtree.

Refer to the /accessibilityTree documentation for usage examples and supported parameters.