curl -sS -X POST "https://api.adscrawl.net/cdp/sessions" \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"idleTimeoutMs": 600000,
"maxSessionMs": 3600000,
"browserSettings": {
"viewport": { "width": 1440, "height": 900 },
"countryCode": "GLOBAL",
"userAgentMode": "random",
"userAgentOs": "windows"
}
}'
{
"idleTimeoutMs": 600000,
"maxSessionMs": 3600000,
"browserSettings": {
"viewport": { "width": 1440, "height": 900 },
"countryCode": "GLOBAL",
"userAgentMode": "random",
"userAgentOs": "windows"
}
}
{
"sessionId": "6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef",
"expiresAt": "2026-04-21T10:30:00.000Z",
"cdpBaseUrl": "https://api.adscrawl.net/cdp/sessions/6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef?token=<data-token>"
}
{
"error": "CDP sessions per API key limit reached"
}
远程 CDP
创建 CDP 会话
启动一个专用的 Chromium 实例并返回一个带有嵌入式数据令牌的 CDP 基础 URL，用于经过身份验证的浏览器控制。
POST
/
cdp
/
sessions
curl -sS -X POST "https://api.adscrawl.net/cdp/sessions" \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"idleTimeoutMs": 600000,
"maxSessionMs": 3600000,
"browserSettings": {
"viewport": { "width": 1440, "height": 900 },
"countryCode": "GLOBAL",
"userAgentMode": "random",
"userAgentOs": "windows"
}
}'
{
"idleTimeoutMs": 600000,
"maxSessionMs": 3600000,
"browserSettings": {
"viewport": { "width": 1440, "height": 900 },
"countryCode": "GLOBAL",
"userAgentMode": "random",
"userAgentOs": "windows"
}
}
{
"sessionId": "6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef",
"expiresAt": "2026-04-21T10:30:00.000Z",
"cdpBaseUrl": "https://api.adscrawl.net/cdp/sessions/6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef?token=<data-token>"
}
{
"error": "CDP sessions per API key limit reached"
}
创建一个新的专用 CDP 会话。服务器会启动一个 Chromium 实例，应用你的
browserSettings，然后返回一个 cdpBaseUrl，你可以直接将其传递给 playwright.connectOverCDP() 或用于手动 CDP 发现。
number
会话在空闲多长时间（毫秒）后被终止。高于服务器上限的值将被静默截断。
number
会话的最大总生命周期（毫秒）。高于服务器上限的值将被静默截断。
object
Chromium 实例启动时应用的浏览器配置。
显示 browserSettings 字段
显示 browserSettings 字段
object
浏览器窗口尺寸：
{ "width": number, "height": number }。CDP 会话将这些值作为 --window-size 启动参数应用。string
浏览器区域设置，例如
en-US。string
IANA 时区标识符，例如
Asia/Shanghai。object
地理坐标：
{ "latitude": number, "longitude": number }。object
string
托管代理区域。使用
"GLOBAL" 自动选择一个热门区域，或使用特定区域代码获取带动态回退的可信代理。省略此字段将随机选择一个可信代理。string
覆盖默认的 User-Agent 字符串。
string
设置为
"random" 让服务器从其 User-Agent 库中选择。未提供 User-Agent 的请求默认使用 "random"。string
当
userAgentMode 为 "random" 时使用的操作系统。接受 "windows"（默认）或 "macos"。object
CDP 指纹覆盖。省略时，
canvas 和 webGlImage 默认为 real；所有其他信号均从一致的随机化配置文件中生成。显示 fingerprint 字段
显示 fingerprint 字段
string
"forward" 使用代理出口地址；也接受 "real" 或 "disabled"。string
WebGL vendor 和 renderer 元数据：
"random" 或 "real"。string
"random" 遵循 WebGL GPU 选择。也接受 "real" 或 "disabled"。当 webGlImage 为 "real" 时，不能为 "random"。string
WebGL 图像噪声：
"random" 或 "real"。string
Canvas 噪声：
"random" 或 "real"。string
音频指纹噪声：
"random" 或 "real"。string
布局测量噪声：
"random" 或 "real"。string
与操作系统匹配的语音列表：
"random" 或 "real"。string
与操作系统匹配的字体列表：
"random" 或 "real"。string
CPU 线程数和内存（作为一对生成）：
"random" 或 "real"。string
Do Not Track 偏好：
"random"、"enabled" 或 "disabled"。array
响应
string
活跃会话的唯一标识符。用于所有后续的列出、删除和 CDP 请求。
string
会话将过期的 RFC 3339 时间戳。
string
此会话的完整 base URL。直接传递给
playwright.connectOverCDP()。它已经包含作为查询参数的数据令牌：不要替换或追加你的 API 密钥。cdpBaseUrl 携带一个内嵌的数据令牌，用于授权 CDP 访问。切勿将该令牌替换为你的 x-api-key。妥善存储它，并像对待凭据一样对待它。| Status | 含义 |
|---|---|
201 | 会话创建成功。 |
400 | 托管区域、自定义代理或随机 User-Agent 参数无效。 |
401 | x-api-key 缺失或无效。 |
429 | API 密钥已达到并发 CDP 会话限制。 |
502 | 浏览器后端拒绝了请求体、返回了过大的结果，或无法启动浏览器。 |
503 | 总容量已超出，或浏览器后端不可用。 |
504 | 会话启动或队列超时。 |
500 | 未分类的内部错误。 |
curl -sS -X POST "https://api.adscrawl.net/cdp/sessions" \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"idleTimeoutMs": 600000,
"maxSessionMs": 3600000,
"browserSettings": {
"viewport": { "width": 1440, "height": 900 },
"countryCode": "GLOBAL",
"userAgentMode": "random",
"userAgentOs": "windows"
}
}'
{
"idleTimeoutMs": 600000,
"maxSessionMs": 3600000,
"browserSettings": {
"viewport": { "width": 1440, "height": 900 },
"countryCode": "GLOBAL",
"userAgentMode": "random",
"userAgentOs": "windows"
}
}
{
"sessionId": "6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef",
"expiresAt": "2026-04-21T10:30:00.000Z",
"cdpBaseUrl": "https://api.adscrawl.net/cdp/sessions/6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef?token=<data-token>"
}
{
"error": "CDP sessions per API key limit reached"
}