快速入门
获取您的 API 密钥
访问 Scraping Browser 控制面板，并在设置选项卡中获取您的 API 密钥。我们将在后续步骤中使用此 API 密钥。
参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| token | string | 在控制面板中生成的 API 密钥。 |
| sessionTTL | number | 控制会话持续时间，并在超时后自动关闭浏览器实例。以秒 (s) 为单位，默认为 180 秒（3 分钟），可自定义范围为 60 秒（1 分钟）到 900 秒（建议最大 15 分钟，但可以设置更长时间）。一旦达到指定的 TTL，会话将过期，Scraping Browser 将关闭浏览器实例以释放资源。 |
| sessionName | string | 为您的会话设置一个名称，以便在历史会话列表中查找和查看。 |
| sessionRecording | boolean | 是否启用会话录制。启用后，将自动录制整个浏览器会话执行过程，会话完成后可在历史会话列表详情中回放查看。默认为 false。 |
| proxyURL | string | 用于设置浏览器的代理 URL，例如：http://user:pass@ip:port。如果设置此参数，所有其他 proxy_* 参数将被忽略。💡自定义代理功能目前仅对订阅用户开放。 在此升级 |
| proxyCountry | string | 指定代理路由的目标国家/地区，通过所选位置的 IP 地址转发请求。接受 ISO 国家代码（例如，US 代表美国，GB 代表英国，ANY 代表随机选择）。支持 195+ 个国家和地区。与 proxyState 和 proxyCity 结合使用时，可实现精确到城市级别的地理定位。 |
| proxyState | string | （可选） 指定所选国家/地区内的目标州/省，以实现更精细的代理路由。必须与 proxyCountry 结合使用。接受州代码（例如，CA 代表加利福尼亚，NY 代表纽约）。适用于具有明确州/省划分的特定国家/地区。 了解更多 |
| proxyCity | string | （可选） 指定所选州/省内的目标城市，以实现城市级别的代理路由。必须与 proxyCountry 和 proxyState 结合使用。提供最精确的地理定位。可用性取决于特定城市的代理基础设施。 了解更多 |
| extensionIds | string | 通过扩展 ID 设置浏览器扩展，多个扩展用逗号分隔 |
| fingerprint | string | 浏览器指纹是利用您的浏览器和设备配置信息创建的几乎唯一的“数字指纹”，即使没有 Cookie 也可以用于跟踪您的在线活动。幸运的是，在 Scraping Browser 中配置指纹是可选的。我们提供浏览器指纹的深度定制，例如浏览器用户代理、时区、语言和屏幕分辨率等核心参数，并支持通过自定义启动参数扩展功能。适用于多账号管理、数据采集和隐私保护场景，使用 scrapeless 自有的 Chromium 浏览器完全避免检测。默认情况下，我们的 Scraping Browser 服务为每个会话生成一个随机指纹。 参考 |
完整的 Scraping Browser WebSocket 连接 URL 示例：
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=ANYwss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=US&proxyState=CA&proxyCity=Los%20Angeleswss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyURL=proxyURL注意：当指定 proxyURL 时，它将优先，其他与代理相关的参数（proxyCountry、proxyState、proxyCity）将被忽略。地理代理参数必须一起使用：proxyState 需要 proxyCountry，而 proxyCity 需要 proxyCountry 和 proxyState。