Use this endpoint when you want a running browser immediately without a separate create-then-start flow. A single POST /cloud-browsers/launch saves a new profile and starts it, blocking until the browser reaches running state before returning 201. The response includes runtime.connectUrl. Open that URL in a browser signed in as the profile owner to access the interactive session. The saved profile persists after you stop the browser and can be restarted, queried, or deleted just like any manually created profile.
Each call to this endpoint creates a new profile with no idempotency key. Never automatically retry a failed launch request. If the response includes an id, inspect that profile and call POST /cloud-browsers/{id}/stop (with retries) before attempting a new launch.
object
required
Custom proxy configuration. Required on every request regardless of authentication method. No saved proxy, managed region, or previous run’s proxy can replace this field.Supply either the server form or the split protocol + host + port form:
server — full URL: http://proxy.example.com:8080 or socks5://proxy.example.com:1080. Must include an explicit port (1–65535). Must not contain embedded credentials, path, query, or fragment. Cannot be combined with host.
protocol — http or socks5.
host — proxy hostname.
port — integer or numeric string from 1 to 65535.
Omit both username and password for an unauthenticated proxy, or supply both as non-empty strings. A proxy failure must never fall back to a direct connection.
array
HTTP(S) URLs to open as tabs when the browser starts. Defaults to [] (no tabs injected). Up to 8 entries; each URL must be at most 16,384 bytes without embedded credentials, control characters, or surrounding whitespace. Each entry is either a URL string or an object { url, active? }. Set active: true on at most one tab to make it the active tab; the first tab becomes active when none is selected.
array
Cookies to inject before the browser opens. Defaults to []. Up to 10,000 entries within the 1 MiB request limit. Required fields per entry: name, domain (non-empty strings); value defaults to an empty string. Optional fields: path (defaults to /), secure, httpOnly, session (booleans), expires (Unix seconds), sameSite (Strict | Lax | None). Expired entries are filtered; unknown fields and invalid types are rejected.
object
Browser fingerprint settings for this session. Defaults: webRtc=forward; all other signals (webGl, webGpu, webGlImage, canvas, audioContext, clientRects, speechVoices, fonts, hardware, doNotTrack) default to random. Partial input fills remaining defaults. Optional hardwareConcurrency and deviceMemory accept integers 1–64; the server generates the runtime seed.
string (UUID)
Required when authenticating with a session cookie or Authorization: Bearer. Selects which of your active API keys to use for billing. When authenticating with x-api-key directly, this field is optional. If supplied, it must match the key used in the header.
Response
Returned only after the browser reaches running state. The Location response header points to GET /cloud-browsers/{id} for subsequent queries.
boolean
Always true on success.
string (UUID)
Persistent profile identifier. Store this immediately; you need it to stop, query, or delete the browser.
string
Always "launch" for profiles created via this endpoint.
boolean
Always false. The profile is retained after the browser stops.
object
Runtime state at the moment the response is sent.
Show Runtime fields
string
neko or worker_cdp. neko omits cdpBaseUrl.
string
Always "running" in a successful 201 response.
string
Active session identifier.
string (RFC3339)
Session expiry timestamp.
string
Direct URL to the interactive browser viewer. Open this in a browser signed in as the profile owner. Use the URL exactly as returned; never construct it manually or append API keys, cookies, or proxy credentials.
Error status codes
Code
Meaning
400
PROXY_REQUIRED, INVALID_PROXY, INVALID_TABS, INVALID_COOKIES, or INVALID_FINGERPRINT_SETTINGS. Explicit null, unknown fields, invalid JSON, and incorrect types are all rejected before any profile is created.
401
Authentication is missing, invalid, or expired.
402
PAID_PLAN_REQUIRED or INSUFFICIENT_CREDITS. No profile is created.
403
The supplied apiKeyId belongs to another user or does not match the authenticated key. No profile is created.
409
Either the saved-profile allowance is full (Cloud Browser limit reached) or the running allowance is full or zero (CLOUD_BROWSER_CONCURRENCY_LIMIT). When a profile was created before the conflict was detected, the response includes id, source: "launch", deleteOnStop: false, deleted: false, and the actual runtime status. The profile remains saved and counts toward your allowance.
502 / 503 / 504 / 500
Errors that occur after profile creation include id, runtime, and Location in the response body. Cleanup may leave the session in stopping state, which still reserves a running slot until confirmed stopped.
When the response contains an id alongside a 5xx status, do not automatically retry the launch. Instead, call POST /cloud-browsers/{id}/stop with a bounded retry loop until runtime.status reaches stopped, then decide whether to launch again.
{"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/cloud-browsers-launch","slug":"/api-reference/cloud-browsers-launch","pageMetadata":{"title":"Create and Launch Browser","sidebarTitle":"Launch Browser","description":"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.","api":"POST /cloud-browsers/launch","playground":"interactive","href":"/api-reference/cloud-browsers-launch"},"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: \"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.\"\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`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Table,Warning}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint when you want a running browser immediately without a separate create-then-start flow. A single `,_jsx(_components.code,{children:`POST /cloud-browsers/launch`}),` saves a new profile and starts it, blocking until the browser reaches `,_jsx(_components.code,{children:`running`}),` state before returning `,_jsx(_components.code,{children:`201`}),`. The response includes `,_jsx(_components.code,{children:`runtime.connectUrl`}),`. Open that URL in a browser signed in as the profile owner to access the interactive session. The saved profile persists after you stop the browser and can be restarted, queried, or deleted just like any manually created profile.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Each call to this endpoint creates a new profile with no idempotency key. Never automatically retry a failed launch request. If the response includes an `,_jsx(_components.code,{children:`id`}),`, inspect that profile and call `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),` (with retries) before attempting a new launch.`]})}),`\n`,_jsxs(ParamField,{body:`proxy`,type:`object`,required:true,id:`param-proxy`,children:[_jsx(_components.p,{children:`Custom proxy configuration. Required on every request regardless of authentication method. No saved proxy, managed region, or previous run’s proxy can replace this field.`}),_jsxs(_components.p,{children:[`Supply either the `,_jsx(_components.code,{children:`server`}),` form or the split `,_jsx(_components.code,{children:`protocol`}),` + `,_jsx(_components.code,{children:`host`}),` + `,_jsx(_components.code,{children:`port`}),` form:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`server`}),` — full URL: `,_jsx(_components.code,{children:`http://proxy.example.com:8080`}),` or `,_jsx(_components.code,{children:`socks5://proxy.example.com:1080`}),`. Must include an explicit port (1–65535). Must not contain embedded credentials, path, query, or fragment. Cannot be combined with `,_jsx(_components.code,{children:`host`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`protocol`}),` — `,_jsx(_components.code,{children:`http`}),` or `,_jsx(_components.code,{children:`socks5`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`host`}),` — proxy hostname.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`port`}),` — integer or numeric string from 1 to 65535.`]}),`\n`]}),_jsxs(_components.p,{children:[`Omit both `,_jsx(_components.code,{children:`username`}),` and `,_jsx(_components.code,{children:`password`}),` for an unauthenticated proxy, or supply both as non-empty strings. A proxy failure must never fall back to a direct connection.`]})]}),`\n`,_jsx(ParamField,{body:`tabs`,type:`array`,id:`param-tabs`,children:_jsxs(_components.p,{children:[`HTTP(S) URLs to open as tabs when the browser starts. Defaults to `,_jsx(_components.code,{children:`[]`}),` (no tabs injected). Up to 8 entries; each URL must be at most 16,384 bytes without embedded credentials, control characters, or surrounding whitespace. Each entry is either a URL string or an object `,_jsx(_components.code,{children:`{ url, active? }`}),`. Set `,_jsx(_components.code,{children:`active: true`}),` on at most one tab to make it the active tab; the first tab becomes active when none is selected.`]})}),`\n`,_jsx(ParamField,{body:`cookies`,type:`array`,id:`param-cookies`,children:_jsxs(_components.p,{children:[`Cookies to inject before the browser opens. Defaults to `,_jsx(_components.code,{children:`[]`}),`. Up to 10,000 entries within the 1 MiB request limit. Required fields per entry: `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`domain`}),` (non-empty strings); `,_jsx(_components.code,{children:`value`}),` defaults to an empty string. Optional fields: `,_jsx(_components.code,{children:`path`}),` (defaults to `,_jsx(_components.code,{children:`/`}),`), `,_jsx(_components.code,{children:`secure`}),`, `,_jsx(_components.code,{children:`httpOnly`}),`, `,_jsx(_components.code,{children:`session`}),` (booleans), `,_jsx(_components.code,{children:`expires`}),` (Unix seconds), `,_jsx(_components.code,{children:`sameSite`}),` (`,_jsx(_components.code,{children:`Strict`}),` | `,_jsx(_components.code,{children:`Lax`}),` | `,_jsx(_components.code,{children:`None`}),`). Expired entries are filtered; unknown fields and invalid types are rejected.`]})}),`\n`,_jsx(ParamField,{body:`fingerprint`,type:`object`,id:`param-fingerprint`,children:_jsxs(_components.p,{children:[`Browser fingerprint settings for this session. Defaults: `,_jsx(_components.code,{children:`webRtc=forward`}),`; all other signals (`,_jsx(_components.code,{children:`webGl`}),`, `,_jsx(_components.code,{children:`webGpu`}),`, `,_jsx(_components.code,{children:`webGlImage`}),`, `,_jsx(_components.code,{children:`canvas`}),`, `,_jsx(_components.code,{children:`audioContext`}),`, `,_jsx(_components.code,{children:`clientRects`}),`, `,_jsx(_components.code,{children:`speechVoices`}),`, `,_jsx(_components.code,{children:`fonts`}),`, `,_jsx(_components.code,{children:`hardware`}),`, `,_jsx(_components.code,{children:`doNotTrack`}),`) default to random. Partial input fills remaining defaults. Optional `,_jsx(_components.code,{children:`hardwareConcurrency`}),` and `,_jsx(_components.code,{children:`deviceMemory`}),` accept integers 1–64; the server generates the runtime seed.`]})}),`\n`,_jsx(ParamField,{body:`apiKeyId`,type:`string (UUID)`,id:`param-api-key-id`,children:_jsxs(_components.p,{children:[`Required when authenticating with a session cookie or `,_jsx(_components.code,{children:`Authorization: Bearer`}),`. Selects which of your active API keys to use for billing. When authenticating with `,_jsx(_components.code,{children:`x-api-key`}),` directly, this field is optional. If supplied, it must match the key used in the header.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returned only after the browser reaches `,_jsx(_components.code,{children:`running`}),` state. The `,_jsx(_components.code,{children:`Location`}),` response header points to `,_jsx(_components.code,{children:`GET /cloud-browsers/{id}`}),` for subsequent queries.`]}),`\n`,_jsx(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),` on success.`]})}),`\n`,_jsx(ResponseField,{name:`id`,type:`string (UUID)`,id:`param-id`,children:_jsx(_components.p,{children:`Persistent profile identifier. Store this immediately; you need it to stop, query, or delete the browser.`})}),`\n`,_jsx(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`\"launch\"`}),` for profiles created via this endpoint.`]})}),`\n`,_jsx(ResponseField,{name:`deleteOnStop`,type:`boolean`,id:`param-delete-on-stop`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`false`}),`. The profile is retained after the browser stops.`]})}),`\n`,_jsxs(ResponseField,{name:`runtime`,type:`object`,id:`param-runtime`,children:[_jsx(_components.p,{children:`Runtime state at the moment the response is sent.`}),_jsxs(Expandable,{title:`Runtime fields`,children:[_jsx(ResponseField,{name:`runtimeKind`,type:`string`,id:`param-runtime-kind`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`neko`}),` or `,_jsx(_components.code,{children:`worker_cdp`}),`. `,_jsx(_components.code,{children:`neko`}),` omits `,_jsx(_components.code,{children:`cdpBaseUrl`}),`.`]})}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`\"running\"`}),` in a successful `,_jsx(_components.code,{children:`201`}),` response.`]})}),_jsx(ResponseField,{name:`sessionId`,type:`string`,id:`param-session-id`,children:_jsx(_components.p,{children:`Active session identifier.`})}),_jsx(ResponseField,{name:`expiresAt`,type:`string (RFC3339)`,id:`param-expires-at`,children:_jsx(_components.p,{children:`Session expiry timestamp.`})}),_jsx(ResponseField,{name:`connectUrl`,type:`string`,id:`param-connect-url`,children:_jsx(_components.p,{children:`Direct URL to the interactive browser viewer. Open this in a browser signed in as the profile owner. Use the URL exactly as returned; never construct it manually or append API keys, cookies, or proxy credentials.`})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`error-status-codes`,children:`Error status codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PROXY_REQUIRED`}),`, `,_jsx(_components.code,{children:`INVALID_PROXY`}),`, `,_jsx(_components.code,{children:`INVALID_TABS`}),`, `,_jsx(_components.code,{children:`INVALID_COOKIES`}),`, or `,_jsx(_components.code,{children:`INVALID_FINGERPRINT_SETTINGS`}),`. Explicit `,_jsx(_components.code,{children:`null`}),`, unknown fields, invalid JSON, and incorrect types are all rejected before any profile is created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Authentication is missing, invalid, or expired.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`402`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PAID_PLAN_REQUIRED`}),` or `,_jsx(_components.code,{children:`INSUFFICIENT_CREDITS`}),`. No profile is created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsxs(_components.td,{children:[`The supplied `,_jsx(_components.code,{children:`apiKeyId`}),` belongs to another user or does not match the authenticated key. No profile is created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsxs(_components.td,{children:[`Either the saved-profile allowance is full (`,_jsx(_components.code,{children:`Cloud Browser limit reached`}),`) or the running allowance is full or zero (`,_jsx(_components.code,{children:`CLOUD_BROWSER_CONCURRENCY_LIMIT`}),`). When a profile was created before the conflict was detected, the response includes `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`source: \"launch\"`}),`, `,_jsx(_components.code,{children:`deleteOnStop: false`}),`, `,_jsx(_components.code,{children:`deleted: false`}),`, and the actual runtime status. The profile remains saved and counts toward your allowance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502 / 503 / 504 / 500`}),_jsxs(_components.td,{children:[`Errors that occur after profile creation include `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`runtime`}),`, and `,_jsx(_components.code,{children:`Location`}),` in the response body. Cleanup may leave the session in `,_jsx(_components.code,{children:`stopping`}),` state, which still reserves a running slot until confirmed stopped.`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`When the response contains an `,_jsx(_components.code,{children:`id`}),` alongside a 5xx status, do not automatically retry the launch. Instead, call `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),` with a bounded retry loop until `,_jsx(_components.code,{children:`runtime.status`}),` reaches `,_jsx(_components.code,{children:`stopped`}),`, then decide whether to launch again.`]})})]})}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 and Launch Browser","sidebarTitle":"Launch Browser","description":"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.","api":"POST /cloud-browsers/launch","playground":"interactive","href":"/api-reference/cloud-browsers-launch"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint when you want a running browser immediately without a separate create-then-start flow. A single `,_jsx(_components.code,{children:`POST /cloud-browsers/launch`}),` saves a new profile and starts it, blocking until the browser reaches `,_jsx(_components.code,{children:`running`}),` state before returning `,_jsx(_components.code,{children:`201`}),`. The response includes `,_jsx(_components.code,{children:`runtime.connectUrl`}),`. Open that URL in a browser signed in as the profile owner to access the interactive session. The saved profile persists after you stop the browser and can be restarted, queried, or deleted just like any manually created profile.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Each call to this endpoint creates a new profile with no idempotency key. Never automatically retry a failed launch request. If the response includes an `,_jsx(_components.code,{children:`id`}),`, inspect that profile and call `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),` (with retries) before attempting a new launch.`]})}),`\n`,_jsxs(ParamField,{body:`proxy`,type:`object`,required:true,id:`param-proxy`,children:[_jsx(_components.p,{children:`Custom proxy configuration. Required on every request regardless of authentication method. No saved proxy, managed region, or previous run’s proxy can replace this field.`}),_jsxs(_components.p,{children:[`Supply either the `,_jsx(_components.code,{children:`server`}),` form or the split `,_jsx(_components.code,{children:`protocol`}),` + `,_jsx(_components.code,{children:`host`}),` + `,_jsx(_components.code,{children:`port`}),` form:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`server`}),` — full URL: `,_jsx(_components.code,{children:`http://proxy.example.com:8080`}),` or `,_jsx(_components.code,{children:`socks5://proxy.example.com:1080`}),`. Must include an explicit port (1–65535). Must not contain embedded credentials, path, query, or fragment. Cannot be combined with `,_jsx(_components.code,{children:`host`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`protocol`}),` — `,_jsx(_components.code,{children:`http`}),` or `,_jsx(_components.code,{children:`socks5`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`host`}),` — proxy hostname.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`port`}),` — integer or numeric string from 1 to 65535.`]}),`\n`]}),_jsxs(_components.p,{children:[`Omit both `,_jsx(_components.code,{children:`username`}),` and `,_jsx(_components.code,{children:`password`}),` for an unauthenticated proxy, or supply both as non-empty strings. A proxy failure must never fall back to a direct connection.`]})]}),`\n`,_jsx(ParamField,{body:`tabs`,type:`array`,id:`param-tabs`,children:_jsxs(_components.p,{children:[`HTTP(S) URLs to open as tabs when the browser starts. Defaults to `,_jsx(_components.code,{children:`[]`}),` (no tabs injected). Up to 8 entries; each URL must be at most 16,384 bytes without embedded credentials, control characters, or surrounding whitespace. Each entry is either a URL string or an object `,_jsx(_components.code,{children:`{ url, active? }`}),`. Set `,_jsx(_components.code,{children:`active: true`}),` on at most one tab to make it the active tab; the first tab becomes active when none is selected.`]})}),`\n`,_jsx(ParamField,{body:`cookies`,type:`array`,id:`param-cookies`,children:_jsxs(_components.p,{children:[`Cookies to inject before the browser opens. Defaults to `,_jsx(_components.code,{children:`[]`}),`. Up to 10,000 entries within the 1 MiB request limit. Required fields per entry: `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`domain`}),` (non-empty strings); `,_jsx(_components.code,{children:`value`}),` defaults to an empty string. Optional fields: `,_jsx(_components.code,{children:`path`}),` (defaults to `,_jsx(_components.code,{children:`/`}),`), `,_jsx(_components.code,{children:`secure`}),`, `,_jsx(_components.code,{children:`httpOnly`}),`, `,_jsx(_components.code,{children:`session`}),` (booleans), `,_jsx(_components.code,{children:`expires`}),` (Unix seconds), `,_jsx(_components.code,{children:`sameSite`}),` (`,_jsx(_components.code,{children:`Strict`}),` | `,_jsx(_components.code,{children:`Lax`}),` | `,_jsx(_components.code,{children:`None`}),`). Expired entries are filtered; unknown fields and invalid types are rejected.`]})}),`\n`,_jsx(ParamField,{body:`fingerprint`,type:`object`,id:`param-fingerprint`,children:_jsxs(_components.p,{children:[`Browser fingerprint settings for this session. Defaults: `,_jsx(_components.code,{children:`webRtc=forward`}),`; all other signals (`,_jsx(_components.code,{children:`webGl`}),`, `,_jsx(_components.code,{children:`webGpu`}),`, `,_jsx(_components.code,{children:`webGlImage`}),`, `,_jsx(_components.code,{children:`canvas`}),`, `,_jsx(_components.code,{children:`audioContext`}),`, `,_jsx(_components.code,{children:`clientRects`}),`, `,_jsx(_components.code,{children:`speechVoices`}),`, `,_jsx(_components.code,{children:`fonts`}),`, `,_jsx(_components.code,{children:`hardware`}),`, `,_jsx(_components.code,{children:`doNotTrack`}),`) default to random. Partial input fills remaining defaults. Optional `,_jsx(_components.code,{children:`hardwareConcurrency`}),` and `,_jsx(_components.code,{children:`deviceMemory`}),` accept integers 1–64; the server generates the runtime seed.`]})}),`\n`,_jsx(ParamField,{body:`apiKeyId`,type:`string (UUID)`,id:`param-api-key-id`,children:_jsxs(_components.p,{children:[`Required when authenticating with a session cookie or `,_jsx(_components.code,{children:`Authorization: Bearer`}),`. Selects which of your active API keys to use for billing. When authenticating with `,_jsx(_components.code,{children:`x-api-key`}),` directly, this field is optional. If supplied, it must match the key used in the header.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returned only after the browser reaches `,_jsx(_components.code,{children:`running`}),` state. The `,_jsx(_components.code,{children:`Location`}),` response header points to `,_jsx(_components.code,{children:`GET /cloud-browsers/{id}`}),` for subsequent queries.`]}),`\n`,_jsx(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),` on success.`]})}),`\n`,_jsx(ResponseField,{name:`id`,type:`string (UUID)`,id:`param-id`,children:_jsx(_components.p,{children:`Persistent profile identifier. Store this immediately; you need it to stop, query, or delete the browser.`})}),`\n`,_jsx(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`\"launch\"`}),` for profiles created via this endpoint.`]})}),`\n`,_jsx(ResponseField,{name:`deleteOnStop`,type:`boolean`,id:`param-delete-on-stop`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`false`}),`. The profile is retained after the browser stops.`]})}),`\n`,_jsxs(ResponseField,{name:`runtime`,type:`object`,id:`param-runtime`,children:[_jsx(_components.p,{children:`Runtime state at the moment the response is sent.`}),_jsxs(Expandable,{title:`Runtime fields`,children:[_jsx(ResponseField,{name:`runtimeKind`,type:`string`,id:`param-runtime-kind`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`neko`}),` or `,_jsx(_components.code,{children:`worker_cdp`}),`. `,_jsx(_components.code,{children:`neko`}),` omits `,_jsx(_components.code,{children:`cdpBaseUrl`}),`.`]})}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`\"running\"`}),` in a successful `,_jsx(_components.code,{children:`201`}),` response.`]})}),_jsx(ResponseField,{name:`sessionId`,type:`string`,id:`param-session-id`,children:_jsx(_components.p,{children:`Active session identifier.`})}),_jsx(ResponseField,{name:`expiresAt`,type:`string (RFC3339)`,id:`param-expires-at`,children:_jsx(_components.p,{children:`Session expiry timestamp.`})}),_jsx(ResponseField,{name:`connectUrl`,type:`string`,id:`param-connect-url`,children:_jsx(_components.p,{children:`Direct URL to the interactive browser viewer. Open this in a browser signed in as the profile owner. Use the URL exactly as returned; never construct it manually or append API keys, cookies, or proxy credentials.`})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`error-status-codes`,children:`Error status codes`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PROXY_REQUIRED`}),`, `,_jsx(_components.code,{children:`INVALID_PROXY`}),`, `,_jsx(_components.code,{children:`INVALID_TABS`}),`, `,_jsx(_components.code,{children:`INVALID_COOKIES`}),`, or `,_jsx(_components.code,{children:`INVALID_FINGERPRINT_SETTINGS`}),`. Explicit `,_jsx(_components.code,{children:`null`}),`, unknown fields, invalid JSON, and incorrect types are all rejected before any profile is created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:`Authentication is missing, invalid, or expired.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`402`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PAID_PLAN_REQUIRED`}),` or `,_jsx(_components.code,{children:`INSUFFICIENT_CREDITS`}),`. No profile is created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsxs(_components.td,{children:[`The supplied `,_jsx(_components.code,{children:`apiKeyId`}),` belongs to another user or does not match the authenticated key. No profile is created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsxs(_components.td,{children:[`Either the saved-profile allowance is full (`,_jsx(_components.code,{children:`Cloud Browser limit reached`}),`) or the running allowance is full or zero (`,_jsx(_components.code,{children:`CLOUD_BROWSER_CONCURRENCY_LIMIT`}),`). When a profile was created before the conflict was detected, the response includes `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`source: \"launch\"`}),`, `,_jsx(_components.code,{children:`deleteOnStop: false`}),`, `,_jsx(_components.code,{children:`deleted: false`}),`, and the actual runtime status. The profile remains saved and counts toward your allowance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502 / 503 / 504 / 500`}),_jsxs(_components.td,{children:[`Errors that occur after profile creation include `,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`runtime`}),`, and `,_jsx(_components.code,{children:`Location`}),` in the response body. Cleanup may leave the session in `,_jsx(_components.code,{children:`stopping`}),` state, which still reserves a running slot until confirmed stopped.`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`When the response contains an `,_jsx(_components.code,{children:`id`}),` alongside a 5xx status, do not automatically retry the launch. Instead, call `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),` with a bounded retry loop until `,_jsx(_components.code,{children:`runtime.status`}),` reaches `,_jsx(_components.code,{children:`stopped`}),`, then decide whether to launch again.`]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`26`,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:`26`,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:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --silent`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --show-error`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --max-time`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 200`}),_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:` -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/cloud-browsers/launch'`}),_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: \u003capi-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:` -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:` --data`}),_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:` \"proxy\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"server\": \"http://proxy.example.com:8080\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"username\": \"\u003cproxy-user>\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"password\": \"\u003cproxy-password>\"`})}),`\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:` \"tabs\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://example.com\"`})}),`\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:` \"cookies\": [`})}),`\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:` \"name\": \"sid\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"value\": \"\u003ccookie-value>\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"domain\": \"example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"path\": \"/\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"secure\": true`})}),`\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(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fingerprint\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"canvas\": \"real\"`})}),`\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`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`201 Running`,numberOfLines:`13`,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:`13`,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:` \"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cbrowser-id>\"`}),_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:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"launch\"`}),_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:` \"deleteOnStop\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"runtime\"`}),_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:` \"runtimeKind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"neko\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"running\"`}),_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:`\"\u003csession-id>\"`}),_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-09-07T09:00: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:` \"connectUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.adscrawl.net/cloud-browser-runtime/\u003csession-id>/?usr=adscrawl\u0026pwd=adscrawl\"`})]}),`\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`]})})}),_jsx(CodeBlock,{filename:`504 Stopping (cleanup in progress)`,numberOfLines:`14`,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:`14`,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:`\"Cloud browser runtime request timed out\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CLOUD_RUNTIME_TIMEOUT\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cbrowser-id>\"`}),_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:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"launch\"`}),_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:` \"deleteOnStop\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"deleted\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"runtime\"`}),_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:` \"runtimeKind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"neko\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"stopping\"`}),_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:`\"\u003csession-id>\"`}),_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-09-07T09:00:00.000Z\"`})]}),`\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`]})})})]})]})}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 and Launch Browser","sidebarTitle":"Launch Browser","description":"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.","api":"POST /cloud-browsers/launch","playground":"interactive","href":"/api-reference/cloud-browsers-launch"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":2,"children":[{"title":"Error status codes","slug":"error-status-codes","depth":3,"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=\"26\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --fail-with-body\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --silent\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --show-error\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> --max-time\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\"> 200\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\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/cloud-browsers/launch'\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: \u0026#x3C;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\"> -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\"> --data\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"proxy\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"server\": \"http://proxy.example.com:8080\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"username\": \"\u0026#x3C;proxy-user>\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"password\": \"\u0026#x3C;proxy-password>\"\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\"> \"tabs\": [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://example.com\"\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\"> \"cookies\": [\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\"> \"name\": \"sid\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"value\": \"\u0026#x3C;cookie-value>\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"domain\": \"example.com\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"path\": \"/\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"secure\": true\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\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"fingerprint\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"canvas\": \"real\"\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>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201 Running","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=\"13\">\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\"> \"ok\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u0026#x3C;browser-id>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"launch\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"deleteOnStop\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"runtime\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"runtimeKind\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"neko\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"running\"\u003c/span>\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\">\"\u0026#x3C;session-id>\"\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-09-07T09:00: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\"> \"connectUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api.adscrawl.net/cloud-browser-runtime/\u0026#x3C;session-id>/?usr=adscrawl\u0026#x26;pwd=adscrawl\"\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>"},{"filename":"504 Stopping (cleanup in progress)","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=\"14\">\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\">\"Cloud browser runtime request timed out\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"CLOUD_RUNTIME_TIMEOUT\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u0026#x3C;browser-id>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"source\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"launch\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"deleteOnStop\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"deleted\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"runtime\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"runtimeKind\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"neko\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"stopping\"\u003c/span>\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\">\"\u0026#x3C;session-id>\"\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-09-07T09:00:00.000Z\"\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":[]}},"endpoint":{"title":"Create and Launch Browser","path":"/cloud-browsers/launch","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":{"proxy":[{"type":"object","properties":{},"description":"Custom proxy configuration. Required on every request regardless of authentication method. No saved proxy, managed region, or previous run’s proxy can replace this field. Supply either the `server` form or the split `protocol` + `host` + `port` form: `server` — full URL: `http://proxy.example.com:8080` or `socks5://proxy.example.com:1080` . Must include an explicit port (1–65535). Must not contain embedded credentials, path, query, or fragment. Cannot be combined with `host` . `protocol` — `http` or `socks5` . `host` — proxy hostname. `port` — integer or numeric string from 1 to 65535. Omit both `username` and `password` for an unauthenticated proxy, or supply both as non-empty strings. A proxy failure must never fall back to a direct connection.","required":true}],"tabs":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"HTTP(S) URLs to open as tabs when the browser starts. Defaults to `[]` (no tabs injected). Up to 8 entries; each URL must be at most 16,384 bytes without embedded credentials, control characters, or surrounding whitespace. Each entry is either a URL string or an object `{ url, active? }` . Set `active: true` on at most one tab to make it the active tab; the first tab becomes active when none is selected."}],"cookies":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Cookies to inject before the browser opens. Defaults to `[]` . Up to 10,000 entries within the 1 MiB request limit. Required fields per entry: `name` , `domain` (non-empty strings); `value` defaults to an empty string. Optional fields: `path` (defaults to `/` ), `secure` , `httpOnly` , `session` (booleans), `expires` (Unix seconds), `sameSite` ( `Strict` | `Lax` | `None` ). Expired entries are filtered; unknown fields and invalid types are rejected."}],"fingerprint":[{"type":"object","properties":{},"description":"Browser fingerprint settings for this session. Defaults: `webRtc=forward` ; all other signals ( `webGl` , `webGpu` , `webGlImage` , `canvas` , `audioContext` , `clientRects` , `speechVoices` , `fonts` , `hardware` , `doNotTrack` ) default to random. Partial input fills remaining defaults. Optional `hardwareConcurrency` and `deviceMemory` accept integers 1–64; the server generates the runtime seed."}],"apiKeyId":[{"type":"object","properties":{},"description":"Required when authenticating with a session cookie or `Authorization: Bearer` . Selects which of your active API keys to use for billing. When authenticating with `x-api-key` directly, this field is optional. If supplied, it must match the key used in the header."}]}}],"examples":{"example":{"value":{"proxy":{},"tabs":[{}],"cookies":[{}],"fingerprint":{},"apiKeyId":{}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"ok":[{"type":"boolean","description":"Always `true` on success."}],"id":[{"type":"object","properties":{},"description":"Persistent profile identifier. Store this immediately; you need it to stop, query, or delete the browser."}],"source":[{"type":"string","description":"Always `\"launch\"` for profiles created via this endpoint."}],"deleteOnStop":[{"type":"boolean","description":"Always `false` . The profile is retained after the browser stops."}],"runtime":[{"type":"object","properties":{"runtimeKind":[{"type":"string","description":"`neko` or `worker_cdp` . `neko` omits `cdpBaseUrl` ."}],"status":[{"type":"string","description":"Always `\"running\"` in a successful `201` response."}],"sessionId":[{"type":"string","description":"Active session identifier."}],"expiresAt":[{"type":"object","properties":{},"description":"Session expiry timestamp."}],"connectUrl":[{"type":"string","description":"Direct URL to the interactive browser viewer. Open this in a browser signed in as the profile owner. Use the URL exactly as returned; never construct it manually or append API keys, cookies, or proxy credentials."}]},"description":"Runtime state at the moment the response is sent."}]}}],"examples":{"example":{"value":{"ok":true,"id":{},"source":"\u003cstring>","deleteOnStop":true,"runtime":{"runtimeKind":"\u003cstring>","status":"\u003cstring>","sessionId":"\u003cstring>","expiresAt":{},"connectUrl":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":["/_mintlify/custom/adscrawl/06c522f789ce028e/salesmartly.js"],"subdomain":"adscrawl","siteName":"AdsCrawl","title":"Create and Launch Browser - AdsCrawl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/cloud-browsers-launch","matchLevel":0},"zh":{"href":"/zh/api-reference/cloud-browsers-launch","matchLevel":1}}},"lastModified":"2026-09-29T03:36:15.478Z","originalFileLocation":"api-reference/cloud-browsers-launch.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=\"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.\">\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 and Launch Browser - AdsCrawl\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AdsCrawl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch\">\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=Cloud+Browsers\u0026amp;title=Create+and+Launch+Browser\u0026amp;description=Create+a+cloud+browser+profile+and+start+it+in+one+request.+Returns+201+only+after+the+browser+reaches+running+state+with+a+live+connectUrl.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=995901c110db8a0e62f39ca1cdb44abc9a85bc3cb8df768341afcbe16edea32d\">\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 and Launch Browser - AdsCrawl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adscrawl.mintlify.site/_mintlify/api/og/v2?division=Cloud+Browsers\u0026amp;title=Create+and+Launch+Browser\u0026amp;description=Create+a+cloud+browser+profile+and+start+it+in+one+request.+Returns+201+only+after+the+browser+reaches+running+state+with+a+live+connectUrl.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=995901c110db8a0e62f39ca1cdb44abc9a85bc3cb8df768341afcbe16edea32d\">\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/cloud-browsers-launch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cloud-browsers-launch.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.adscrawl.net/zh/api-reference/cloud-browsers-launch\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch\">\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/cloud-browsers-launch#webpage\",\"url\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch\",\"name\":\"Create and Launch Browser\",\"description\":\"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.\",\"dateModified\":\"2026-09-29T03:36:15.478Z\",\"isPartOf\":{\"@id\":\"https://docs.adscrawl.net#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloud Browsers\",\"item\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create and Launch Browser\",\"item\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch#apireference\",\"headline\":\"Create and Launch Browser\",\"name\":\"Create and Launch Browser\",\"description\":\"Create a cloud browser profile and start it in one request. Returns 201 only after the browser reaches running state with a live connectUrl.\",\"url\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-launch#webpage\"},\"dateModified\":\"2026-09-29T03:36:15.478Z\",\"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/cloud-browsers-launch.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","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","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","description":"Save a new cloud browser profile with optional viewport, locale, proxy, cookies, and fingerprint settings. No browser session starts and no running quota is consumed.","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","description":"Start a saved cloud browser profile and wait for it to reach running state. Returns 200 with a live connectUrl only after the browser is ready.","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/cloud-browsers-launch"}]}]},"basePath":"","title":"Create and Launch Browser - 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"]}