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 发现。
Chromium 实例启动时应用的浏览器配置。
显示 browserSettings 字段
显示 browserSettings 字段
CDP 指纹覆盖。省略时,
canvas 和 webGlImage 默认为 real;所有其他信号均从一致的随机化配置文件中生成。显示 fingerprint 字段
显示 fingerprint 字段
响应
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"
}