Switch Proxy (Browser)

The Switch Proxy command (Command Type: 999) configures proxy settings for the browser scraper, with support for link-based proxy assignment.

Command Type

Command Type ID: 999

Parameters

Parameter	Type	Description	Required
server	string	Proxy server address (host:port or URL)	Yes
timeout	number	Timeout in milliseconds	Yes
bypass	string	Comma-separated domains to bypass proxy (e.g., `".com, chromium.org"`)	No
linkOptions	LinkOptions	Get proxy from a LINK configuration	No
password	string	Password for HTTP proxy authentication	No
timezone	string	Timezone of the proxy in IANA format	No
username	string	Username for HTTP proxy authentication	No

LinkOptions

Field	Type	Description	Required
consumerName	string	Name of the consumer using the link	Yes
countries	Array of string	Countries for the LINK target (ISO codes)	Yes
endpoint	string	Endpoint associated with LINK	Yes
isValidation	boolean	Whether the LINK target uses validation	Yes
targetId	string	Identifier for the LINK target	Yes
fallbackProxy	FallbackProxy	Optional fallback proxy	No
fingerprintId	number	Fingerprint identifier	No
labels	object	Metrics labels (key-value pairs)	No

Usage Examples

Set a Direct Proxy

{
  "command": "switch-proxy",
  "params": {
    "server": "proxy.example.com:8080",
    "timeout": 10000,
    "username": "user",
    "password": "%{PROXY_PASSWORD}"
  }
}

Use Link-Based Proxy

{
  "command": "switch-proxy",
  "params": {
    "server": "proxy.link.example.com:8080",
    "timeout": 10000,
    "linkOptions": {
      "consumerName": "scraper-1",
      "countries": ["US"],
      "endpoint": "proxy-endpoint",
      "isValidation": false,
      "targetId": "proxy-target-id"
    }
  }
}

Switch Timezone (Browser) - Switch browser timezone

Quick Start

Commands Glossary

Switch Proxy (Browser)

Command Type

Parameters

LinkOptions

Usage Examples

Set a Direct Proxy

Use Link-Based Proxy

​Command Type

​Parameters

​LinkOptions

​Usage Examples

​Set a Direct Proxy

​Use Link-Based Proxy

​Related Commands

Command Type

Parameters

LinkOptions

Usage Examples

Set a Direct Proxy

Use Link-Based Proxy

Related Commands