Skip to main content
POST
/
sessions
/
{session_id}
/
page
/
execute
python
from notte_sdk import NotteClient, actions

notte = NotteClient()
with notte.Session() as session:
    # go to google
    _ = session.execute(
        actions.Goto(
            url="https://www.duckduckgo.com"
        )
    )

    # fill the search bar with our query
    _ = session.execute(
        actions.Fill(
            value="dog pictures",
            selector='internal:role=combobox[name="Search with DuckDuckGo"i]',
        )
    )
{
  "action": {
    "value": {},
    "type": "form_fill",
    "category": "Special Browser Actions",
    "description": "Fill a form with multiple values. Important: If you detect a form requesting personal information, try to use this action at first, and otherwise use the regular fill action. CRITICAL: If this action fails once, use the regular form fill instead."
  },
  "success": true,
  "message": "<string>",
  "session": {
    "session_id": "<string>",
    "timeout_minutes": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "last_accessed_at": "2023-11-07T05:31:56Z",
    "status": "active",
    "closed_at": "2023-11-07T05:31:56Z",
    "duration": "<string>",
    "steps": [
      {}
    ],
    "error": "<string>",
    "credit_usage": 123,
    "proxies": false,
    "browser_type": "chromium",
    "use_file_storage": false,
    "network_request_bytes": 0,
    "network_response_bytes": 0
  },
  "data": {
    "markdown": "<string>",
    "images": [
      {
        "url": "<string>",
        "category": "favicon",
        "description": "<string>"
      }
    ],
    "structured": {
      "success": true,
      "error": "<string>",
      "data": {}
    }
  },
  "exception": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

x-notte-request-origin
string | null
x-notte-sdk-version
string | null

Path Parameters

session_id
string
required

Body

application/json
value
Value · object
required
type
string
default:form_fill
Allowed value: "form_fill"
category
string
default:Special Browser Actions
description
string
default:Fill a form with multiple values. Important: If you detect a form requesting personal information, try to use this action at first, and otherwise use the regular fill action. CRITICAL: If this action fails once, use the regular form fill instead.

Response

Successful Response

action
FormFillAction · object
required
success
boolean
required
message
string
required
session
SessionResponse · object
required

Browser session information

data
DataSpace · object
exception
string | null