fetch

Issue an HTTP request from the page the session is on and return the response

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

The request runs inside the browser through fetch(), so it carries the page’s cookies, the session’s proxy and the browser’s own network fingerprint. A relative url resolves against the current page, which also makes it same-origin; a cross-origin URL is subject to CORS exactly as in a browser tab, so goto the target origin first. Redirects are followed and the final URL is on response.url. The result is a standard requests.Response: a non-2xx status is returned, not raised, and response.raise_for_status() raises requests.HTTPError. A network failure surfaces as the JavaScript error.

json is serialised as the body with an application/json content type, data as a form body when it is a mapping or verbatim when it is a string.

session.execute(type="goto", url="https://en.wikipedia.org/wiki/Main_Page")
summary = session.fetch("/api/rest_v1/page/summary/Main_Page").json()

Parameters

url · str · required

method · str · default: "GET"

headers · UnionType[Mapping[str, str], None] · default: "None"

params · UnionType[Mapping[str, Any], None] · default: "None"

json · Any · default: "None"

data · UnionType[str, Mapping[str, Any], None] · default: "None"

timeout · UnionType[float, None] · default: "None"

Returns

Response