​
Overview

Notte offers a flexible proxy system, enabling you to control how your automation traffic is routed across the internet. Whether you need anonymity, geolocation control, or improved reliability, Notte makes it easy to integrate proxies into your workflows.

​
Configuration Options

With Notte, you can:
  • Use built-in proxies: Effortlessly route traffic through our managed residential proxies
  • Bring your own proxies: Use custom HTTP/HTTPS proxies for greater control over network routing
  • Combine multiple proxies: Set custom routing rules to direct traffic through different proxies based on domain or location
Proxies are configured when creating a session through the API or SDK.

​
Built-in Proxies

Use Notte’s built-in proxies to route traffic through managed, residential proxies. This is the simplest option and requires very little setup. Setting proxies=True will make a best-effort attempt to use a US-based proxy. If nearby US proxies are unavailable, we may route through nearby countries (like Canada). 
from notte_sdk import NotteClient

notte = NotteClient()

# Start a session with built-in proxies
with notte.Session(proxies=True) as session:
    _ = session.observe(url="https://www.notte.cc/")
the proxies parameter can also be customized to use a specific country proxy as follows: 
from notte_sdk.types import NotteProxy
proxies = NotteProxy.from_country("fr")

​
Custom Proxies

Notte supports custom proxy configurations, allowing you to route traffic through your own HTTP or HTTPS proxies. This is useful if you need to enforce specific network routing rules, comply with security policies, or optimize performance with a preferred proxy provider. 
from notte_sdk import NotteClient
from notte_sdk.types import ExternalProxy

notte = NotteClient()

# Configure custom proxy settings
proxy_settings = ExternalProxy(
    server="http://your-proxy-server:port",
    username="your-username",
    password="your-password",
)

# Start a session with custom proxy
with notte.Session(proxies=[proxy_settings]) as session:
    # use your session
    pass

​
Usage Measurement

Proxy usage is measured by the total amount of data transferred through the proxy. This includes:
  • Webpage content, downloads, and media files
  • HTTP headers, authentication data, and encryption overhead
  • Any requests and responses routed through the proxy
Since all traffic must pass through the proxy server before reaching its final destination, every interaction contributes to your total bandwidth usage.