快速上手
获取您的 API 密钥
访问爬虫浏览器控制面板，并在设置选项卡中获取您的 API 密钥。我们将在接下来的步骤中使用此 API 密钥。
参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| token | string | 在控制面板中生成的 API 密钥。 |
| session_ttl | number | 控制会话持续时间，并在超时后自动关闭浏览器实例。以秒 (s) 为单位，默认为 180 秒（3 分钟），可在 60 秒（1 分钟）和 900 秒（推荐最大 15 分钟，但可以设置更长的时长）之间自定义。达到指定的 TTL 后，会话将过期，爬虫浏览器将关闭浏览器实例以释放资源。 |
| session_name | string | 设置会话名称，以便于在历史会话列表中搜索和查看。 |
| session_recording | boolean | 是否启用会话录制。启用后，整个浏览器会话执行过程将被自动录制，会话完成后，可以在历史会话列表详情中回放和查看。默认为 false。 |
| proxy_url | string | 用于设置浏览器的代理 URL，例如：http://user:pass@ip:port。如果设置此参数，则所有其他 proxy_* 参数将被忽略。- 💡自定义代理功能目前仅对企业版和企业增强版订阅用户可用 立即升级 - 💡企业级自定义用户可以 联系我们 使用自定义代理。 |
| proxy_country | string | 设置代理的目标国家/地区，通过来自该地区的 IP 地址发送请求。您可以指定国家代码（例如，美国为 US，英国为 GB，任何国家为 ANY）。有关所有受支持的选项，请参阅 国家代码。 |
| extension_ids | string | 通过扩展 ID 设置浏览器扩展，多个扩展用逗号分隔 |
| fingerprint | string | 浏览器指纹是使用您的浏览器和设备配置信息创建的几乎唯一的“数字指纹”，即使没有 Cookie，它也可以用来跟踪您的在线活动。幸运的是，在 Scraping Browser 中配置指纹是可选的。我们提供浏览器指纹的深度自定义，例如浏览器用户代理、时区、语言和屏幕分辨率等核心参数，并支持通过自定义启动参数扩展功能。适用于多账户管理、数据采集和隐私保护场景，使用 scrapeless 自身的 Chromium 浏览器完全避免检测。默认情况下，我们的 Scraping Browser 服务为每个会话生成一个随机指纹。 参考 |
完整的 Scraping Browser WebSocket 连接 URL 示例：
wss://browser.scrapeless.com/browser?token=APIKey&session_ttl=180&proxy_country=ANYwss://browser.scrapeless.com/browser?token=APIKey&session_ttl=180&proxy_url=proxy_url注意: 当指定 proxy_url 时，它具有优先级，其他与代理相关的参数（proxy_country）将被忽略。