Using Proxies

Proxy configuration

Use auth.proxy to route the browser through an HTTP/HTTPS proxy.

{
  "url": "https://example.com",
  "auth": {
    "proxy": "http://user:pass@proxy.example.com:3128"
  }
}

When to use

• Geo-specific content.
• IP-based access controls.
• Sites that block data center IPs.

Tips

• Prefer stable residential or premium proxies.
• Increase wait.timeout_ms for proxy latency.
• Rotate exit nodes if assets fail to load.