orthogonal-sh/notte

Notte - Browser Automation API

Control browser sessions, scrape web pages, and run autonomous AI agents.

Capabilities

• Take Screenshot: Take a screenshot of the current page
• Get Session: Get session status and details (free)
• Stop Session: Stop and clean up a browser session (free)
• Get Session Cookies: Get all cookies from the browser session (free)
• Get Network Logs: Get network request/response logs from the session (free)
• Get Agent Status: Get agent execution status and results (free)
• Observe Page: Observe the current page state and get available actions
• Stop Agent: Stop a running agent (free)
• Scrape Webpage: Scrape content from a URL without managing sessions
• Execute Page Action: Execute an action on the page (click, type, navigate, etc
• Set Session Cookies: Set cookies in the browser session
• Start Session: Start a new browser session
• Scrape from HTML: Extract structured content from raw HTML without using a browser
• Start Agent: Start an AI agent to autonomously complete a browser task
• Scrape Page: Scrape content from the current page in the session

Usage

Take Screenshot

Take a screenshot of the current page.

Parameters:

• full_page (boolean) - Capture full page
• session_id* (string)

orth api run notte /sessions/{session_id}/page/screenshot --body '{}'

Get Session (free)

Get session status and details.

Parameters:

• session_id* (string)

orth api run notte /sessions/{session_id}

Stop Session (free)

Stop and clean up a browser session.

Parameters:

• session_id* (string) - Session ID

orth api run notte /sessions/{session_id}/stop

Get Session Cookies (free)

Get all cookies from the browser session.

Parameters:

• session_id* (string)

orth api run notte /sessions/{session_id}/cookies

Get Network Logs (free)

Get network request/response logs from the session.

Parameters:

• session_id* (string)

orth api run notte /sessions/{session_id}/network/logs --query session_id=example

Get Agent Status (free)

Get agent execution status and results.

Parameters:

• agent_id* (string)

orth api run notte /agents/{agent_id}

Observe Page

Observe the current page state and get available actions.

Parameters:

• max_nb_actions (number) - Maximum actions to return (default: 100)
• min_nb_actions (number) - Minimum actions to return
• instruction (string) - Optional instruction to filter actions
• session_id* (string)

orth api run notte /sessions/{session_id}/page/observe --body '{"instruction": "Find the search box"}'

Stop Agent (free)

Stop a running agent.

Parameters:

• session_id* (string) - Session ID the agent is running on

orth api run notte /agents/{agent_id}/stop

Scrape Webpage

Scrape content from a URL without managing sessions.

Parameters:

• url* (string) - URL to scrape
• schema (object) - Structured extraction schema

orth api run notte /scrape --body '{"url": "https://example.com"}'

Execute Page Action

Execute an action on the page (click, type, navigate, etc.).

Parameters:

• type* (string) - Action type: goto, click, type, scroll, select, hover, wait, screenshot
• url (string) - URL for goto action
• ref (string) - Element reference for click/type/select actions
• text (string) - Text for type action
• value (string) - Value for select action
• direction (string) - Scroll direction: up/down
• amount (number) - Scroll amount in pixels
• timeout (number) - Wait timeout in ms
• session_id* (string)

orth api run notte /sessions/{session_id}/page/execute --body '{"instruction": "Click the search button"}'

Set Session Cookies

Set cookies in the browser session.

Parameters:

• cookies* (array) - Array of cookie objects
• session_id* (string)

orth api run notte /sessions/{session_id}/cookies

Start Session

Start a new browser session. Configure browser type, proxies, viewport, and session timeout.

Parameters:

• headless (boolean) - Run in headless mode (default: true)
• browser_type (string) - Browser type: chromium, chrome, firefox
• proxies (boolean) - Enable proxy rotation
• solve_captchas (boolean) - Auto-solve CAPTCHAs
• idle_timeout_minutes (integer) - Idle timeout (default: 3)
• max_duration_minutes (integer) - Max duration (default: 15)
• viewport_width (integer)
• viewport_height (integer)
• user_agent (string)

orth api run notte /sessions/start --body '{
  "url": "https://example.com",
  "timeout_minutes": 5
}'

Scrape from HTML

Extract structured content from raw HTML without using a browser

Parameters:

• frames* (array) - Array of HTML frames to parse

orth api run notte /scrape_from_html --body '{"html": "<html><body>Hello</body></html>"}'

Start Agent

Start an AI agent to autonomously complete a browser task.

Parameters:

• task* (string) - Task for the AI agent to perform
• session_id* (string) - Session ID to run the agent on
• url (string) - Starting URL
• max_steps (number) - Max steps (1-50, default: 20)
• use_vision (boolean) - Use vision model (default: true)

orth api run notte /agents/start --body '{
  "task": "Search for AI news on Google and summarize the top results",
  "url": "https://google.com"
}'

Scrape Page

Scrape content from the current page in the session.

Parameters:

• selector (string) - Playwright selector to scope the scrape
• scrape_links (boolean) - Scrape links (default: true)
• scrape_images (boolean) - Scrape images (default: false)
• only_main_content (boolean) - Only main content, exclude nav/footer (default: true)
• response_format (object) - Pydantic model or JSON Schema for structured extraction
• instructions (string) - Additional extraction instructions
• session_id* (string)

orth api run notte /sessions/{session_id}/page/scrape --body '{}'

Use Cases

1. Web Scraping: Extract structured data from any webpage
2. Browser Automation: Automate complex browser workflows
3. Testing: Run automated browser tests
4. AI Agents: Deploy autonomous agents for web tasks
5. Monitoring: Track website changes and content

Discover More

For full endpoint details and parameters:

orth api show notte              # List all endpoints
orth api show notte /sessions   # Get endpoint details