{ "error": "CDP sessions per API key limit reached"}
Create a new dedicated CDP session. The server starts a Chromium instance, applies your browserSettings, and returns a cdpBaseUrl you can pass directly to playwright.connectOverCDP() or use for manual CDP discovery.
number
Milliseconds of inactivity before the session is terminated. Values above the server cap are silently clamped.
number
Maximum total lifetime of the session in milliseconds. Values above the server cap are silently clamped.
object
Browser configuration applied when the Chromium instance starts.
Show browserSettings fields
object
Browser window dimensions: { "width": number, "height": number }. CDP sessions apply these as the --window-size launch argument.
string
Browser locale, e.g. en-US.
string
IANA timezone identifier, e.g. Asia/Shanghai.
object
Geographic coordinates: { "latitude": number, "longitude": number }.
object
Custom proxy configuration. Cannot be combined with countryCode.
Show proxy fields
string
Full proxy URL such as http://host:port or socks5://host:port. Do not embed credentials here; provide them via username and password separately. Cannot be combined with host.
string
Proxy protocol for the split form: http or socks5.
string
Proxy host for the split form.
number
Proxy port (1 to 65535) for the split form.
string
Proxy username.
string
Proxy password.
string
Managed proxy region. Use "GLOBAL" to select a popular region automatically, or a specific region code for trusted proxies with dynamic fallback. Omitting this field picks a random trusted proxy.
string
Override the default User-Agent string.
string
Set to "random" to have the server choose from its User-Agent library. Requests without a User-Agent default to "random".
string
Operating system used when userAgentMode is "random". Accepts "windows" (default) or "macos".
object
CDP fingerprint overrides. When omitted, canvas and webGlImage default to real; all other signals are generated from a coherent randomized profile.
Show fingerprint fields
string
"forward" uses the proxy exit address; "real" or "disabled" also accepted.
string
WebGL vendor and renderer metadata: "random" or "real".
string
"random" follows the WebGL GPU selection. Also accepts "real" or "disabled". Cannot be "random" when webGlImage is "real".
string
WebGL image noise: "random" or "real".
string
Canvas noise: "random" or "real".
string
Audio fingerprint noise: "random" or "real".
string
Layout measurement noise: "random" or "real".
string
OS-matched speech voice list: "random" or "real".
string
OS-matched font list: "random" or "real".
string
CPU thread count and memory (generated as a pair): "random" or "real".
string
Do Not Track preference: "random", "enabled", or "disabled".
array
Cookies injected into the browser context before the session starts.
Show cookie fields
string
required
Cookie name.
string
required
Cookie value.
string
required
Target domain, e.g. .example.com.
string
Cookie path. Defaults to /.
boolean
When true, the cookie is only sent over HTTPS.
boolean
When true, the cookie is inaccessible to client-side JavaScript.
string
SameSite attribute value.
boolean
Set to true for a session cookie.
number
Unix expiry timestamp in seconds. Also accepted as expires or expiry.
Response
string
Unique identifier for the active session. Use it for all subsequent list, delete, and CDP requests.
string
RFC 3339 timestamp when the session will expire.
string
Fully formed base URL for this session. Pass it directly to playwright.connectOverCDP(). It already contains the data token as a query parameter: do not replace or append your API key.
The cdpBaseUrl carries an embedded data token that authorizes CDP access. Never replace that token with your x-api-key. Store it securely and treat it with the same care as a credential.
Status
Meaning
201
Session created successfully.
400
Invalid managed region, custom proxy, or random User-Agent parameters.
401
Missing or invalid x-api-key.
429
The API key has reached its concurrent CDP session limit.
502
The browser backend rejected the payload, returned an oversized result, or failed to start the browser.
503
Total capacity exceeded, or the browser backend is unavailable.
{ "error": "CDP sessions per API key limit reached"}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AdsCrawl","description":"Connect with Playwright, Puppeteer, or CDP and run jobs in a full browser environment with residential proxy routing—built for dynamic pages, authenticated sessions, and sites that stop basic scrapers.","colors":{"primary":"#0071e3","light":"#7c7c7e","dark":"#070707"},"logo":{"light":"https://media.brand.dev/4640f1e9-6451-460f-a082-f8c2438d4f3b.svg","dark":"https://mintcdn.com/adscrawl/MOJftQlB9dh80Xox/images/AdsCrawl-Mainlogo2.svg?fit=max\u0026auto=format\u0026n=MOJftQlB9dh80Xox\u0026q=85\u0026s=10300c0754e1fe5c5861c09a260e7d28","href":"https://www.adscrawl.net/"},"favicon":{"light":"https://mintcdn.com/adscrawl/En06nz0S4G8hWrQZ/images/AdsCrawl-Dock4.svg?fit=max\u0026auto=format\u0026n=En06nz0S4G8hWrQZ\u0026q=85\u0026s=c26faf96d0aa9e550d718670e196b8e7","dark":"https://mintcdn.com/adscrawl/En06nz0S4G8hWrQZ/images/AdsCrawl-Dock4.svg?fit=max\u0026auto=format\u0026n=En06nz0S4G8hWrQZ\u0026q=85\u0026s=c26faf96d0aa9e550d718670e196b8e7"},"api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","go"]},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.adscrawl.net"}},"navbar":{"primary":{"type":"button","label":"Start for Free","href":"https://app.adscrawl.net/register/"}},"footer":{"socials":{"github":"https://github.com/AdsCrawl","x":"https://x.com/Adscrawl"}},"seo":{"metatags":{"canonical":"https://docs.adscrawl.net"}},"integrations":{"ga4":{"measurementId":"G-F0ZW9VMNR2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","vscode","mcp","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adscrawl","hasAudioNarration":false,"actualSubdomain":"adscrawl","customDomains":["docs.adscrawl.net"],"gitSource":{"type":"github","owner":"adscrawl","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aedc312644e5d1cbd4c966e","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"zh","tag":"文档","count":24},{"language":"en","tag":"Documentation","count":23},{"language":"en","tag":"API Reference","count":22},{"language":"zh","tag":"API 参考","count":22},{"language":"zh","tag":"快速上手","count":12},{"language":"en","tag":"Get Started","count":11},{"language":"en","tag":"SDKs \u0026 Integrations","count":8},{"language":"zh","tag":"SDK 与集成","count":8},{"language":"en","tag":"Cloud Browsers","count":6},{"language":"en","tag":"Guides","count":6},{"language":"zh","tag":"云浏览器","count":6},{"language":"zh","tag":"使用指南","count":6},{"language":"en","tag":"Remote CDP","count":5},{"language":"en","tag":"Browser Tasks","count":5},{"language":"zh","tag":"远程 CDP","count":5},{"language":"zh","tag":"浏览器任务","count":5},{"language":"en","tag":"AI Scrapers","count":4},{"language":"en","tag":"Core Concepts","count":4},{"language":"zh","tag":"AI Scrapers","count":4},{"language":"zh","tag":"核心概念","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/cdp-sessions","slug":"/api-reference/cdp-sessions","pageMetadata":{"title":"Create CDP Session","sidebarTitle":"Create Session","description":"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.","api":"POST /cdp/sessions","playground":"interactive","href":"/api-reference/cdp-sessions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField,ResponseField,Table}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Create a new dedicated CDP session. The server starts a Chromium instance, applies your `,_jsx(_components.code,{children:`browserSettings`}),`, and returns a `,_jsx(_components.code,{children:`cdpBaseUrl`}),` you can pass directly to `,_jsx(_components.code,{children:`playwright.connectOverCDP()`}),` or use for manual CDP discovery.`]}),`\n`,_jsx(ParamField,{body:`idleTimeoutMs`,type:`number`,id:`param-idle-timeout-ms`,children:_jsx(_components.p,{children:`Milliseconds of inactivity before the session is terminated. Values above the server cap are silently clamped.`})}),`\n`,_jsx(ParamField,{body:`maxSessionMs`,type:`number`,id:`param-max-session-ms`,children:_jsx(_components.p,{children:`Maximum total lifetime of the session in milliseconds. Values above the server cap are silently clamped.`})}),`\n`,_jsxs(ParamField,{body:`browserSettings`,type:`object`,id:`param-browser-settings`,children:[_jsx(_components.p,{children:`Browser configuration applied when the Chromium instance starts.`}),_jsxs(Expandable,{title:`browserSettings fields`,children:[_jsx(ParamField,{body:`viewport`,type:`object`,id:`param-viewport`,children:_jsxs(_components.p,{children:[`Browser window dimensions: `,_jsx(_components.code,{children:`{ \"width\": number, \"height\": number }`}),`. CDP sessions apply these as the `,_jsx(_components.code,{children:`--window-size`}),` launch argument.`]})}),_jsx(ParamField,{body:`locale`,type:`string`,id:`param-locale`,children:_jsxs(_components.p,{children:[`Browser locale, e.g. `,_jsx(_components.code,{children:`en-US`}),`.`]})}),_jsx(ParamField,{body:`timezoneId`,type:`string`,id:`param-timezone-id`,children:_jsxs(_components.p,{children:[`IANA timezone identifier, e.g. `,_jsx(_components.code,{children:`Asia/Shanghai`}),`.`]})}),_jsx(ParamField,{body:`geolocation`,type:`object`,id:`param-geolocation`,children:_jsxs(_components.p,{children:[`Geographic coordinates: `,_jsx(_components.code,{children:`{ \"latitude\": number, \"longitude\": number }`}),`.`]})}),_jsxs(ParamField,{body:`proxy`,type:`object`,id:`param-proxy`,children:[_jsxs(_components.p,{children:[`Custom proxy configuration. Cannot be combined with `,_jsx(_components.code,{children:`countryCode`}),`.`]}),_jsxs(Expandable,{title:`proxy fields`,children:[_jsx(ParamField,{body:`server`,type:`string`,id:`param-server`,children:_jsxs(_components.p,{children:[`Full proxy URL such as `,_jsx(_components.code,{children:`http://host:port`}),` or `,_jsx(_components.code,{children:`socks5://host:port`}),`. Do not embed credentials here; provide them via `,_jsx(_components.code,{children:`username`}),` and `,_jsx(_components.code,{children:`password`}),` separately. Cannot be combined with `,_jsx(_components.code,{children:`host`}),`.`]})}),_jsx(ParamField,{body:`protocol`,type:`string`,id:`param-protocol`,children:_jsxs(_components.p,{children:[`Proxy protocol for the split form: `,_jsx(_components.code,{children:`http`}),` or `,_jsx(_components.code,{children:`socks5`}),`.`]})}),_jsx(ParamField,{body:`host`,type:`string`,id:`param-host`,children:_jsx(_components.p,{children:`Proxy host for the split form.`})}),_jsx(ParamField,{body:`port`,type:`number`,id:`param-port`,children:_jsx(_components.p,{children:`Proxy port (1 to 65535) for the split form.`})}),_jsx(ParamField,{body:`username`,type:`string`,id:`param-username`,children:_jsx(_components.p,{children:`Proxy username.`})}),_jsx(ParamField,{body:`password`,type:`string`,id:`param-password`,children:_jsx(_components.p,{children:`Proxy password.`})})]})]}),_jsx(ParamField,{body:`countryCode`,type:`string`,id:`param-country-code`,children:_jsxs(_components.p,{children:[`Managed proxy region. Use `,_jsx(_components.code,{children:`\"GLOBAL\"`}),` to select a popular region automatically, or a specific region code for trusted proxies with dynamic fallback. Omitting this field picks a random trusted proxy.`]})}),_jsx(ParamField,{body:`userAgent`,type:`string`,id:`param-user-agent`,children:_jsx(_components.p,{children:`Override the default User-Agent string.`})}),_jsx(ParamField,{body:`userAgentMode`,type:`string`,id:`param-user-agent-mode`,children:_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`\"random\"`}),` to have the server choose from its User-Agent library. Requests without a User-Agent default to `,_jsx(_components.code,{children:`\"random\"`}),`.`]})}),_jsx(ParamField,{body:`userAgentOs`,type:`string`,id:`param-user-agent-os`,children:_jsxs(_components.p,{children:[`Operating system used when `,_jsx(_components.code,{children:`userAgentMode`}),` is `,_jsx(_components.code,{children:`\"random\"`}),`. Accepts `,_jsx(_components.code,{children:`\"windows\"`}),` (default) or `,_jsx(_components.code,{children:`\"macos\"`}),`.`]})}),_jsxs(ParamField,{body:`fingerprint`,type:`object`,id:`param-fingerprint`,children:[_jsxs(_components.p,{children:[`CDP fingerprint overrides. When omitted, `,_jsx(_components.code,{children:`canvas`}),` and `,_jsx(_components.code,{children:`webGlImage`}),` default to `,_jsx(_components.code,{children:`real`}),`; all other signals are generated from a coherent randomized profile.`]}),_jsxs(Expandable,{title:`fingerprint fields`,children:[_jsx(ParamField,{body:`webRtc`,type:`string`,id:`param-web-rtc`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"forward\"`}),` uses the proxy exit address; `,_jsx(_components.code,{children:`\"real\"`}),` or `,_jsx(_components.code,{children:`\"disabled\"`}),` also accepted.`]})}),_jsx(ParamField,{body:`webGl`,type:`string`,id:`param-web-gl`,children:_jsxs(_components.p,{children:[`WebGL vendor and renderer metadata: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`webGpu`,type:`string`,id:`param-web-gpu`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`\"random\"`}),` follows the WebGL GPU selection. Also accepts `,_jsx(_components.code,{children:`\"real\"`}),` or `,_jsx(_components.code,{children:`\"disabled\"`}),`. Cannot be `,_jsx(_components.code,{children:`\"random\"`}),` when `,_jsx(_components.code,{children:`webGlImage`}),` is `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`webGlImage`,type:`string`,id:`param-web-gl-image`,children:_jsxs(_components.p,{children:[`WebGL image noise: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`canvas`,type:`string`,id:`param-canvas`,children:_jsxs(_components.p,{children:[`Canvas noise: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`audioContext`,type:`string`,id:`param-audio-context`,children:_jsxs(_components.p,{children:[`Audio fingerprint noise: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`clientRects`,type:`string`,id:`param-client-rects`,children:_jsxs(_components.p,{children:[`Layout measurement noise: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`speechVoices`,type:`string`,id:`param-speech-voices`,children:_jsxs(_components.p,{children:[`OS-matched speech voice list: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`fonts`,type:`string`,id:`param-fonts`,children:_jsxs(_components.p,{children:[`OS-matched font list: `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`hardware`,type:`string`,id:`param-hardware`,children:_jsxs(_components.p,{children:[`CPU thread count and memory (generated as a pair): `,_jsx(_components.code,{children:`\"random\"`}),` or `,_jsx(_components.code,{children:`\"real\"`}),`.`]})}),_jsx(ParamField,{body:`doNotTrack`,type:`string`,id:`param-do-not-track`,children:_jsxs(_components.p,{children:[`Do Not Track preference: `,_jsx(_components.code,{children:`\"random\"`}),`, `,_jsx(_components.code,{children:`\"enabled\"`}),`, or `,_jsx(_components.code,{children:`\"disabled\"`}),`.`]})})]})]}),_jsxs(ParamField,{body:`cookies`,type:`array`,id:`param-cookies`,children:[_jsx(_components.p,{children:`Cookies injected into the browser context before the session starts.`}),_jsxs(Expandable,{title:`cookie fields`,children:[_jsx(ParamField,{body:`name`,type:`string`,required:true,id:`param-name`,children:_jsx(_components.p,{children:`Cookie name.`})}),_jsx(ParamField,{body:`value`,type:`string`,required:true,id:`param-value`,children:_jsx(_components.p,{children:`Cookie value.`})}),_jsx(ParamField,{body:`domain`,type:`string`,required:true,id:`param-domain`,children:_jsxs(_components.p,{children:[`Target domain, e.g. `,_jsx(_components.code,{children:`.example.com`}),`.`]})}),_jsx(ParamField,{body:`path`,type:`string`,id:`param-path`,children:_jsxs(_components.p,{children:[`Cookie path. Defaults to `,_jsx(_components.code,{children:`/`}),`.`]})}),_jsx(ParamField,{body:`secure`,type:`boolean`,id:`param-secure`,children:_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`true`}),`, the cookie is only sent over HTTPS.`]})}),_jsx(ParamField,{body:`httpOnly`,type:`boolean`,id:`param-http-only`,children:_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`true`}),`, the cookie is inaccessible to client-side JavaScript.`]})}),_jsx(ParamField,{body:`sameSite`,type:`string`,id:`param-same-site`,children:_jsx(_components.p,{children:`SameSite attribute value.`})}),_jsx(ParamField,{body:`session`,type:`boolean`,id:`param-session`,children:_jsxs(_components.p,{children:[`Set to `,_jsx(_components.code,{children:`true`}),` for a session cookie.`]})}),_jsx(ParamField,{body:`expirationDate`,type:`number`,id:`param-expiration-date`,children:_jsxs(_components.p,{children:[`Unix expiry timestamp in seconds. Also accepted as `,_jsx(_components.code,{children:`expires`}),` or `,_jsx(_components.code,{children:`expiry`}),`.`]})})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`sessionId`,type:`string`,id:`param-session-id`,children:_jsx(_components.p,{children:`Unique identifier for the active session. Use it for all subsequent list, delete, and CDP requests.`})}),`\n`,_jsx(ResponseField,{name:`expiresAt`,type:`string`,id:`param-expires-at`,children:_jsx(_components.p,{children:`RFC 3339 timestamp when the session will expire.`})}),`\n`,_jsx(ResponseField,{name:`cdpBaseUrl`,type:`string`,id:`param-cdp-base-url`,children:_jsxs(_components.p,{children:[`Fully formed base URL for this session. Pass it directly to `,_jsx(_components.code,{children:`playwright.connectOverCDP()`}),`. It already contains the data token as a query parameter: do not replace or append your API key.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`cdpBaseUrl`}),` carries an embedded data token that authorizes CDP access. Never replace that token with your `,_jsx(_components.code,{children:`x-api-key`}),`. Store it securely and treat it with the same care as a credential.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`201`})}),_jsx(_components.td,{children:`Session created successfully.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Invalid managed region, custom proxy, or random User-Agent parameters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsxs(_components.td,{children:[`Missing or invalid `,_jsx(_components.code,{children:`x-api-key`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:`The API key has reached its concurrent CDP session limit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`502`})}),_jsx(_components.td,{children:`The browser backend rejected the payload, returned an oversized result, or failed to start the browser.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:`Total capacity exceeded, or the browser backend is unavailable.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`504`})}),_jsx(_components.td,{children:`Session startup or queue timeout.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Unclassified internal error.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create CDP Session","sidebarTitle":"Create Session","description":"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.","api":"POST /cdp/sessions","playground":"interactive","href":"/api-reference/cdp-sessions"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[199,217,"pre:`pre`,span:`span`,tbody:`tbody`,td:`"],[297,383,"CodeBlock,Expandable,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_mi"],[573,585,"questExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)"],[13977,14405,",`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.adscrawl.net/cdp/sessions\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"content-type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"idleTimeoutMs\": 600000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"maxSessionMs\": 3600000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"browserSettings\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"viewport\": { \"width\": 1440, \"height\": 900 },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"countryCode\": \"GLOBAL\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userAgentMode\": \"random\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userAgentOs\": \"windows\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Body JSON`,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"idleTimeoutMs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`600000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"maxSessionMs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3600000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"browserSettings\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"viewport\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"width\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1440`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"height\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`900`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countryCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GLOBAL\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"userAgentMode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"random\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"userAgentOs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"windows\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`201 Created`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sessionId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-21T10:30:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cdpBaseUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.adscrawl.net/cdp/sessions/6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef?token=\u003cdata-token>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`429 Rate Limited`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CDP sessions per API key limit reached\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"13\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -sS\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.adscrawl.net/cdp/sessions\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"content-type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: YOUR_API_KEY\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"idleTimeoutMs\": 600000,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"maxSessionMs\": 3600000,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"browserSettings\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"viewport\": { \"width\": 1440, \"height\": 900 },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"countryCode\": \"GLOBAL\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"userAgentMode\": \"random\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"userAgentOs\": \"windows\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Body JSON","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"idleTimeoutMs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">600000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"maxSessionMs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3600000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"browserSettings\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"viewport\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"width\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1440\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"height\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">900\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"countryCode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"GLOBAL\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"userAgentMode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"random\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"userAgentOs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"windows\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201 Created","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"sessionId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expiresAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-04-21T10:30:00.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cdpBaseUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.adscrawl.net/cdp/sessions/6c3f7d14-7fe4-4c8e-9f1b-0b6d6f2fa2ef?token=\u0026#x3C;data-token>\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"429 Rate Limited","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CDP sessions per API key limit reached\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create CDP Session","path":"/cdp/sessions","servers":[{"url":"https://api.adscrawl.net"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"x-api-key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"idleTimeoutMs":[{"type":"number","description":"Milliseconds of inactivity before the session is terminated. Values above the server cap are silently clamped."}],"maxSessionMs":[{"type":"number","description":"Maximum total lifetime of the session in milliseconds. Values above the server cap are silently clamped."}],"browserSettings":[{"type":"object","properties":{"viewport":[{"type":"object","properties":{},"description":"Browser window dimensions: `{ \"width\": number, \"height\": number }` . CDP sessions apply these as the `--window-size` launch argument."}],"locale":[{"type":"string","description":"Browser locale, e.g. `en-US` ."}],"timezoneId":[{"type":"string","description":"IANA timezone identifier, e.g. `Asia/Shanghai` ."}],"geolocation":[{"type":"object","properties":{},"description":"Geographic coordinates: `{ \"latitude\": number, \"longitude\": number }` ."}],"proxy":[{"type":"object","properties":{"server":[{"type":"string","description":"Full proxy URL such as `http://host:port` or `socks5://host:port` . Do not embed credentials here; provide them via `username` and `password` separately. Cannot be combined with `host` ."}],"protocol":[{"type":"string","description":"Proxy protocol for the split form: `http` or `socks5` ."}],"host":[{"type":"string","description":"Proxy host for the split form."}],"port":[{"type":"number","description":"Proxy port (1 to 65535) for the split form."}],"username":[{"type":"string","description":"Proxy username."}],"password":[{"type":"string","description":"Proxy password."}]},"description":"Custom proxy configuration. Cannot be combined with `countryCode` ."}],"countryCode":[{"type":"string","description":"Managed proxy region. Use `\"GLOBAL\"` to select a popular region automatically, or a specific region code for trusted proxies with dynamic fallback. Omitting this field picks a random trusted proxy."}],"userAgent":[{"type":"string","description":"Override the default User-Agent string."}],"userAgentMode":[{"type":"string","description":"Set to `\"random\"` to have the server choose from its User-Agent library. Requests without a User-Agent default to `\"random\"` ."}],"userAgentOs":[{"type":"string","description":"Operating system used when `userAgentMode` is `\"random\"` . Accepts `\"windows\"` (default) or `\"macos\"` ."}],"fingerprint":[{"type":"object","properties":{"webRtc":[{"type":"string","description":"`\"forward\"` uses the proxy exit address; `\"real\"` or `\"disabled\"` also accepted."}],"webGl":[{"type":"string","description":"WebGL vendor and renderer metadata: `\"random\"` or `\"real\"` ."}],"webGpu":[{"type":"string","description":"`\"random\"` follows the WebGL GPU selection. Also accepts `\"real\"` or `\"disabled\"` . Cannot be `\"random\"` when `webGlImage` is `\"real\"` ."}],"webGlImage":[{"type":"string","description":"WebGL image noise: `\"random\"` or `\"real\"` ."}],"canvas":[{"type":"string","description":"Canvas noise: `\"random\"` or `\"real\"` ."}],"audioContext":[{"type":"string","description":"Audio fingerprint noise: `\"random\"` or `\"real\"` ."}],"clientRects":[{"type":"string","description":"Layout measurement noise: `\"random\"` or `\"real\"` ."}],"speechVoices":[{"type":"string","description":"OS-matched speech voice list: `\"random\"` or `\"real\"` ."}],"fonts":[{"type":"string","description":"OS-matched font list: `\"random\"` or `\"real\"` ."}],"hardware":[{"type":"string","description":"CPU thread count and memory (generated as a pair): `\"random\"` or `\"real\"` ."}],"doNotTrack":[{"type":"string","description":"Do Not Track preference: `\"random\"` , `\"enabled\"` , or `\"disabled\"` ."}]},"description":"CDP fingerprint overrides. When omitted, `canvas` and `webGlImage` default to `real` ; all other signals are generated from a coherent randomized profile."}],"cookies":[{"type":"array","items":[{"type":"object","properties":{"name":[{"type":"string","description":"Cookie name.","required":true}],"value":[{"type":"string","description":"Cookie value.","required":true}],"domain":[{"type":"string","description":"Target domain, e.g. `.example.com` .","required":true}],"path":[{"type":"string","description":"Cookie path. Defaults to `/` ."}],"secure":[{"type":"boolean","description":"When `true` , the cookie is only sent over HTTPS."}],"httpOnly":[{"type":"boolean","description":"When `true` , the cookie is inaccessible to client-side JavaScript."}],"sameSite":[{"type":"string","description":"SameSite attribute value."}],"session":[{"type":"boolean","description":"Set to `true` for a session cookie."}],"expirationDate":[{"type":"number","description":"Unix expiry timestamp in seconds. Also accepted as `expires` or `expiry` ."}]}}],"description":"Cookies injected into the browser context before the session starts."}]},"description":"Browser configuration applied when the Chromium instance starts."}]}}],"examples":{"example":{"value":{"idleTimeoutMs":123,"maxSessionMs":123,"browserSettings":{"viewport":{},"locale":"\u003cstring>","timezoneId":"\u003cstring>","geolocation":{},"proxy":{"server":"\u003cstring>","protocol":"\u003cstring>","host":"\u003cstring>","port":123,"username":"\u003cstring>","password":"\u003cstring>"},"countryCode":"\u003cstring>","userAgent":"\u003cstring>","userAgentMode":"\u003cstring>","userAgentOs":"\u003cstring>","fingerprint":{"webRtc":"\u003cstring>","webGl":"\u003cstring>","webGpu":"\u003cstring>","webGlImage":"\u003cstring>","canvas":"\u003cstring>","audioContext":"\u003cstring>","clientRects":"\u003cstring>","speechVoices":"\u003cstring>","fonts":"\u003cstring>","hardware":"\u003cstring>","doNotTrack":"\u003cstring>"},"cookies":[{"name":"\u003cstring>","value":"\u003cstring>","domain":"\u003cstring>","path":"\u003cstring>","secure":true,"httpOnly":true,"sameSite":"\u003cstring>","session":true,"expirationDate":123}]}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"sessionId":[{"type":"string","description":"Unique identifier for the active session. Use it for all subsequent list, delete, and CDP requests."}],"expiresAt":[{"type":"string","description":"RFC 3339 timestamp when the session will expire."}],"cdpBaseUrl":[{"type":"string","description":"Fully formed base URL for this session. Pass it directly to `playwright.connectOverCDP()` . It already contains the data token as a query parameter: do not replace or append your API key."}]}}],"examples":{"example":{"value":{"sessionId":"\u003cstring>","expiresAt":"\u003cstring>","cdpBaseUrl":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/adscrawl/06c522f789ce028e/salesmartly.js"],"subdomain":"adscrawl","siteName":"AdsCrawl","title":"Create CDP Session - AdsCrawl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/cdp-sessions","matchLevel":0},"zh":{"href":"/zh/api-reference/cdp-sessions","matchLevel":1}}},"lastModified":"2026-09-29T03:36:15.483Z","originalFileLocation":"api-reference/cdp-sessions.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AdsCrawl\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create CDP Session - AdsCrawl\">\u003cmeta data-mint-head property=\"og:description\" content=\"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AdsCrawl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adscrawl.net/api-reference/cdp-sessions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adscrawl.mintlify.site/_mintlify/api/og/v2?division=Remote+CDP\u0026amp;title=Create+CDP+Session\u0026amp;description=Launch+a+dedicated+Chromium+instance+and+receive+a+CDP+base+URL+with+an+embedded+data+token+for+authenticated+browser+control.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=e67eee2484db6629a00dd1a0993379dfc82ce26e9612e7f0a4f5c0e254bc07b8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create CDP Session - AdsCrawl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adscrawl.mintlify.site/_mintlify/api/og/v2?division=Remote+CDP\u0026amp;title=Create+CDP+Session\u0026amp;description=Launch+a+dedicated+Chromium+instance+and+receive+a+CDP+base+URL+with+an+embedded+data+token+for+authenticated+browser+control.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=e67eee2484db6629a00dd1a0993379dfc82ce26e9612e7f0a4f5c0e254bc07b8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/adscrawl/K83IBBeEnE6-2SmN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AdsCrawl\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0071e3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.adscrawl.net/api-reference/cdp-sessions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cdp-sessions.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.adscrawl.net/api-reference/cdp-sessions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.adscrawl.net/zh/api-reference/cdp-sessions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.adscrawl.net/api-reference/cdp-sessions\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.adscrawl.net/#organization\",\"name\":\"AdsCrawl\",\"url\":\"https://docs.adscrawl.net\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://media.brand.dev/4640f1e9-6451-460f-a082-f8c2438d4f3b.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.adscrawl.net#website\",\"name\":\"AdsCrawl\",\"url\":\"https://docs.adscrawl.net\",\"publisher\":{\"@id\":\"https://docs.adscrawl.net/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.adscrawl.net/api-reference/cdp-sessions#webpage\",\"url\":\"https://docs.adscrawl.net/api-reference/cdp-sessions\",\"name\":\"Create CDP Session\",\"description\":\"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.\",\"dateModified\":\"2026-09-29T03:36:15.483Z\",\"isPartOf\":{\"@id\":\"https://docs.adscrawl.net#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adscrawl.net/api-reference/cdp-sessions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adscrawl.net/api-reference/cdp-sessions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AdsCrawl\",\"item\":\"https://docs.adscrawl.net\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create CDP Session\",\"item\":\"https://docs.adscrawl.net/api-reference/cdp-sessions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.adscrawl.net/api-reference/cdp-sessions#apireference\",\"headline\":\"Create CDP Session\",\"name\":\"Create CDP Session\",\"description\":\"Launch a dedicated Chromium instance and receive a CDP base URL with an embedded data token for authenticated browser control.\",\"url\":\"https://docs.adscrawl.net/api-reference/cdp-sessions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adscrawl.net/api-reference/cdp-sessions#webpage\"},\"dateModified\":\"2026-09-29T03:36:15.483Z\",\"publisher\":{\"@id\":\"https://docs.adscrawl.net/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.adscrawl.net#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AdsCrawl\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AdsCrawl\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/cdp-sessions.md","siteName":"AdsCrawl","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"AdsCrawl REST API Introduction","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"title":"API Schema Reference — Shared Types for All Endpoints","sidebarTitle":"Schemas","href":"/api-reference/schemas"}]},{"group":"Browser Tasks","pages":[{"title":"Render HTML, Markdown, or Article JSON","sidebarTitle":"Render HTML","api":"POST /html","playground":"interactive","href":"/api-reference/html"},{"title":"Capture Screenshot","sidebarTitle":"Screenshot","api":"POST /screenshot","playground":"interactive","href":"/api-reference/screenshot"},{"title":"Extract SPA Data","sidebarTitle":"Extract SPA Data","api":"POST /spa-extract","playground":"interactive","href":"/api-reference/spa-extract"},{"title":"List Templates","sidebarTitle":"List Templates","api":"GET /spa-extract/templates","playground":"interactive","href":"/api-reference/spa-extract-templates"},{"title":"Similar websites API","sidebarTitle":"Similar websites","description":"Find related websites with POST /similar-sites. Send a URL with your API key, then use website details and relevance scores to build a research shortlist.","api":"POST https://api.adscrawl.net/similar-sites","playground":"simple","href":"/api-reference/similar-sites"}]},{"group":"Remote CDP","pages":[{"title":"Create CDP Session","sidebarTitle":"Create Session","api":"POST /cdp/sessions","playground":"interactive","href":"/api-reference/cdp-sessions"},{"title":"List CDP Sessions","sidebarTitle":"List Sessions","description":"Retrieve all active CDP sessions associated with your API key, including session IDs, expiry times, and CDP base URLs.","api":"GET /cdp/sessions","playground":"interactive","href":"/api-reference/cdp-sessions-list"},{"title":"Delete CDP Session","sidebarTitle":"Delete Session","api":"DELETE /cdp/sessions/{sessionId}","playground":"interactive","href":"/api-reference/cdp-sessions-delete"},{"title":"Discover CDP Endpoint","sidebarTitle":"Discover Endpoint","api":"GET /cdp/sessions/{sessionId}/json/version","playground":"interactive","href":"/api-reference/cdp-sessions-version"},{"title":"Issue Live Control Token","sidebarTitle":"Live Control Token","api":"POST /cdp/live-token","playground":"interactive","href":"/api-reference/cdp-live-token"}]},{"group":"Cloud Browsers","pages":[{"title":"List Cloud Browser Profiles","sidebarTitle":"List Browsers","api":"GET /cloud-browsers","playground":"interactive","href":"/api-reference/cloud-browsers-list"},{"title":"Get Cloud Browser Profile","sidebarTitle":"Get Browser","api":"GET /cloud-browsers/{id}","playground":"interactive","href":"/api-reference/cloud-browsers-get"},{"title":"Create Browser Profile","sidebarTitle":"Create Profile","api":"POST /cloud-browsers","playground":"interactive","href":"/api-reference/cloud-browsers-create"},{"title":"Create and Launch Browser","sidebarTitle":"Launch Browser","api":"POST /cloud-browsers/launch","playground":"interactive","href":"/api-reference/cloud-browsers-launch"},{"title":"Start Cloud Browser","sidebarTitle":"Start Browser","api":"POST /cloud-browsers/{id}/start","playground":"interactive","href":"/api-reference/cloud-browsers-start"},{"title":"Stop Cloud Browser","sidebarTitle":"Stop Browser","api":"POST /cloud-browsers/{id}/stop","playground":"interactive","href":"/api-reference/cloud-browsers-stop"}]},{"group":"AI Scrapers","pages":[{"title":"ChatGPT scraper API","sidebarTitle":"ChatGPT Scraper","api":"POST https://api.adscrawl.net/ai-search","playground":"simple","href":"/api-reference/ai-search"},{"title":"Gemini scraper API","sidebarTitle":"Gemini Scraper","api":"POST https://api.adscrawl.net/ai-search","playground":"simple","href":"/api-reference/gemini-scraper"},{"title":"Google AI Mode scraper API","sidebarTitle":"Google AI Mode Scraper","api":"POST https://api.adscrawl.net/ai-search","playground":"simple","href":"/api-reference/google-ai-mode-scraper"},{"title":"Google AI Overview scraper API","sidebarTitle":"Google AI Overview Scraper","api":"POST https://api.adscrawl.net/ai-search","playground":"simple","href":"/api-reference/google-ai-overview-scraper"}]}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/cdp-sessions"}]}]},"basePath":"","title":"Create CDP Session - AdsCrawl","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js"]}