开始使用
获取您的 API 密钥
访问 Scraping Browser 控制面板,并在设置选项卡中获取您的 API 密钥。我们将在接下来的步骤中使用此 API 密钥。
参数
参数名称 | 类型 | 描述 |
---|---|---|
token | string | 在控制面板中生成的 API 密钥。 |
session_ttl | number | 控制会话持续时间,并在超时后自动关闭浏览器实例。以秒 (s) 为单位,默认值为 180 秒(3 分钟),可在 60 秒(1 分钟)到 900 秒(推荐最大值 15 分钟,但也可以设置更长时间)之间自定义。达到指定的 TTL 后,会话将过期,Scraping Browser 将关闭浏览器实例以释放资源。 |
session_name | string | 为你的会话设置一个名称,便于在历史会话列表进行搜索和查看。 |
session_recording | boolean | 是否开启会话录制,开启后会自动录制整个浏览器会话运行过程,会话完成后可以在历史回话列表详情中进行回放查看,默认值为false |
proxy_url | string | 用于设置浏览器的代理 URL,例如:http://user:pass@ip:port 。如果设置此参数,则所有其他 proxy_* 参数将被忽略。- 💡自定义代理功能目前仅适用于企业版和企业增强版订阅用户 立即升级 - 💡企业级自定义用户可以 联系我们 使用自定义代理。 |
proxy_country | string | 设置代理的目标国家/地区,通过来自该地区的 IP 地址发送请求。您可以指定一个国家代码(例如,美国为 US,英国为 GB,任何国家为 ANY)。查看 国家代码 以了解所有受支持的选项。 |
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=ANY
wss://browser.scrapeless.com/browser?token=APIKey&session_ttl=180&proxy_url=proxy_url
注意: 当指定 proxy_url
时,它具有优先级,其他与代理相关的参数(proxy_country
)将被忽略。