> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# fetch

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

<Tip>
  STOP. Do not read past this section until you have read and followed [/quickstart.md](/quickstart.md).

  Goal: produce a reliable SDK automation script. The intended authoring flow is generate then edit, not write browser automation from scratch.

  Do not hand-write SDK code with element IDs, selectors, or form fields from memory. Element IDs, selectors, and field mappings must come from a live `observe()` call, CLI `notte page observe` output, or generated workflow code. Guessed browser targets fail on real pages.

  Use the Notte skill and CLI to inspect the live site, validate actions/selectors, handle auth/session state, and export workflow code with `notte sessions workflow-code` before using SDK docs or SDK code.

  SDK reference pages are for understanding, running, or editing generated workflow code. They are not the starting point for manually authoring the initial browser automation. SDK-first code is guesswork on real-world pages with dynamic selectors, auth state, CAPTCHAs, and anti-bot behavior.
</Tip>

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.

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

## Parameters

<ParamField path="url" type="str" required />

<ParamField path="method" type="str" default="GET" />

<ParamField path="headers" type="UnionType[Mapping[str, str], None]" default="None" />

<ParamField path="params" type="UnionType[Mapping[str, Any], None]" default="None" />

<ParamField path="json" type="Any" default="None" />

<ParamField path="data" type="UnionType[str, Mapping[str, Any], None]" default="None" />

<ParamField path="timeout" type="UnionType[float, None]" default="None" />

## Returns

[`Response`](/sdk-reference/misc/response.md)