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": {
    "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.",
    "value": {}
  },
  "success": true,
  "message": "<string>",
  "data": {
    "markdown": "<string>",
    "images": [
      {
        "url": "<string>",
        "category": "favicon",
        "description": "<string>"
      }
    ],
    "structured": {
      "success": true,
      "error": "<string>",
      "data": {}
    }
  },
  "exception": "<string>",
  "session": {
    "session_id": "<string>",
    "timeout_minutes": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "closed_at": "2023-11-07T05:31:56Z",
    "last_accessed_at": "2023-11-07T05:31:56Z",
    "duration": "<string>",
    "status": "active",
    "steps": [
      {}
    ],
    "error": "<string>",
    "credit_usage": 123,
    "proxies": false,
    "browser_type": "chromium",
    "use_file_storage": false
  }
}

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
  • FormFillAction
  • GotoAction
  • GotoNewTabAction
  • CloseTabAction
  • SwitchTabAction
  • GoBackAction
  • GoForwardAction
  • ReloadAction
  • WaitAction
  • PressKeyAction
  • ScrollUpAction
  • ScrollDownAction
  • CaptchaSolveAction
  • HelpAction
  • CompletionAction
  • ScrapeAction
  • EmailReadAction
  • SmsReadAction
  • ClickAction
  • FillAction
  • MultiFactorFillAction
  • FallbackFillAction
  • CheckAction
  • SelectDropdownOptionAction
  • UploadFileAction
  • DownloadFileAction

Fill a form with multiple values. Critical: If you detect a form on a page, try to use this action at first, and otherwise use the regular fill action.

Example:

from notte_sdk import actions

session.execute(actions.FormFill(value={"email": "user@example.com", "first_name": "John", "last_name": "Doe"}))
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

API-specific execution response that excludes the exception field for OpenAPI schema generation

action
object
required

Fill a form with multiple values. Critical: If you detect a form on a page, try to use this action at first, and otherwise use the regular fill action.

Example:

from notte_sdk import actions

session.execute(actions.FormFill(value={"email": "user@example.com", "first_name": "John", "last_name": "Doe"}))
  • FormFillAction
  • GotoAction
  • GotoNewTabAction
  • CloseTabAction
  • SwitchTabAction
  • GoBackAction
  • GoForwardAction
  • ReloadAction
  • WaitAction
  • PressKeyAction
  • ScrollUpAction
  • ScrollDownAction
  • CaptchaSolveAction
  • HelpAction
  • CompletionAction
  • ScrapeAction
  • EmailReadAction
  • SmsReadAction
  • ClickAction
  • FillAction
  • MultiFactorFillAction
  • FallbackFillAction
  • CheckAction
  • SelectDropdownOptionAction
  • UploadFileAction
  • DownloadFileAction
success
boolean
required
message
string
required
session
object
required

Browser session information

data
object | null
exception
string | null