{ "error": "Cloud browser cluster has no available capacity", "code": "CLUSTER_NO_CAPACITY", "nextAvailableAt": null, "retryAfterMs": null}
Start a previously saved cloud browser profile by its id. The endpoint blocks until the browser reaches running state and then returns 200 with the full runtime object, including connectUrl, so you can open the interactive session immediately. A successful 200 response means billing has begun: credits are consumed at one credit per started minute from this moment until you call POST /cloud-browsers/{id}/stop.
string (UUID)
required
The persistent profile identifier returned by POST /cloud-browsers (create) or GET /cloud-browsers (list). This is distinct from the runtime sessionId.
object
required
Required on every x-api-key start. You must supply a valid top-level proxy on each start request even if a proxy was saved in the profile’s browserSettings. A saved proxy, a managed countryCode, or a previous run’s proxy cannot satisfy this requirement.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. Start overrides affect this run only and do not update the saved profile.
string (UUID)
Required when authenticating with a session cookie or Authorization: Bearer. Select an active, unexpired API key that belongs to your account. When authenticating with x-api-key, the current key is selected automatically; if apiKeyId is also provided, it must match.
string
Available to session/Bearer callers only; not accepted with x-api-key. Use GLOBAL for a random popular region or a two-letter ISO code such as FR to prefer a trusted proxy in that region with dynamic fallback. An empty string is not a valid selection. Cannot be combined with proxy in the same request. This override affects this run only and does not update the saved profile.
array
Optional per-run cookie override. Takes precedence over any cookies saved in the profile for this run only, without updating the saved profile configuration.
object
Optional per-run fingerprint override, merged by field with saved settings for this run only. Supported fields: webRtc (forward | real | disabled), webGl / webGlImage / canvas / audioContext / clientRects / speechVoices / fonts / hardware (random | real), webGpu (random | real | disabled), doNotTrack (random | enabled | disabled). Legacy hardwareConcurrency and deviceMemory accept integers 1–64. Invalid or conflicting combinations return INVALID_FINGERPRINT_SETTINGS.
Response
boolean
Always true on success.
object
Runtime state at confirmation.
Show Runtime fields
string
neko or worker_cdp. neko omits cdpBaseUrl.
string
Always "running" in a successful 200 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.
Billing runs at 1 credit per started minute from a successful 200 response until you confirm stop via POST /cloud-browsers/{id}/stop. Closing the viewer tab or losing the connection does not stop billing.
Status
Meaning
200
Browser is running. Billing has started.
400
PROXY_REQUIRED (missing top-level proxy for API key), INVALID_PROXY, COUNTRY_PROXY_CONFLICT (proxy and countryCode both supplied), INVALID_COUNTRY_CODE, INVALID_FINGERPRINT_SETTINGS, or invalid cookies. A missing or inactive apiKeyId when using session/Bearer auth also returns 400.
401
Authentication is missing, invalid, or expired.
402
PAID_PLAN_REQUIRED (no active paid plan) or INSUFFICIENT_CREDITS (fewer than one credit available). The response includes balance and requiredCredits fields.
403
The supplied apiKeyId belongs to another user or does not match the authenticated key.
404
The profile does not exist or belongs to another user.
409
CLOUD_BROWSER_CONCURRENCY_LIMIT: your running allowance is full or set to 0. Stop another browser to free a slot before retrying. The response includes runningLimit and runningCount. Or the browser is already running (no code): this profile already has an active session in starting, running, or stopping state. Stop it first, wait for stopped, then start again.
502
CLOUD_RUNTIME_AUTH_FAILED, CLOUD_RUNTIME_NOT_FOUND, CLOUD_RUNTIME_HTTP_ERROR, CLOUD_RUNTIME_INVALID_RESPONSE, or CLOUD_RUNTIME_CONTROLLER_FAILED.
503
CLUSTER_NO_CAPACITY (includes nullable nextAvailableAt and retryAfterMs), CDP session capacity exhausted, MANAGED_PROXY_UNAVAILABLE, DYNAMIC_PROXY_NOT_CONFIGURED, CLOUD_RUNTIME_UNREACHABLE, or CLOUD_RUNTIME_CONFIG_INVALID. A proxy failure never falls back to a direct connection; fix the proxy before retrying.
504
CLOUD_RUNTIME_TIMEOUT. A timeout does not prove the runtime is absent. Inspect the profile’s status and call stop when needed; the running slot remains reserved until cleanup is confirmed.
{ "error": "Cloud browser cluster has no available capacity", "code": "CLUSTER_NO_CAPACITY", "nextAvailableAt": null, "retryAfterMs": null}
{"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-start","slug":"/api-reference/cloud-browsers-start","pageMetadata":{"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"},"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: \"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.\"\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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField,ResponseField,Table}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Start a previously saved cloud browser profile by its `,_jsx(_components.code,{children:`id`}),`. The endpoint blocks until the browser reaches `,_jsx(_components.code,{children:`running`}),` state and then returns `,_jsx(_components.code,{children:`200`}),` with the full runtime object, including `,_jsx(_components.code,{children:`connectUrl`}),`, so you can open the interactive session immediately. A successful `,_jsx(_components.code,{children:`200`}),` response means billing has begun: credits are consumed at one credit per started minute from this moment until you call `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),`.`]}),`\n`,_jsx(ParamField,{path:`id`,type:`string (UUID)`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`The persistent profile identifier returned by `,_jsx(_components.code,{children:`POST /cloud-browsers`}),` (create) or `,_jsx(_components.code,{children:`GET /cloud-browsers`}),` (list). This is distinct from the runtime `,_jsx(_components.code,{children:`sessionId`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`proxy`,type:`object`,required:true,id:`param-proxy`,children:[_jsxs(_components.p,{children:[`Required on every `,_jsx(_components.code,{children:`x-api-key`}),` start. You must supply a valid top-level `,_jsx(_components.code,{children:`proxy`}),` on each start request even if a proxy was saved in the profile’s `,_jsx(_components.code,{children:`browserSettings`}),`. A saved proxy, a managed `,_jsx(_components.code,{children:`countryCode`}),`, or a previous run’s proxy cannot satisfy this requirement.`]}),_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. Start overrides affect this run only and do not update the saved profile.`]})]}),`\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`}),`. Select an active, unexpired API key that belongs to your account. When authenticating with `,_jsx(_components.code,{children:`x-api-key`}),`, the current key is selected automatically; if `,_jsx(_components.code,{children:`apiKeyId`}),` is also provided, it must match.`]})}),`\n`,_jsx(ParamField,{body:`countryCode`,type:`string`,id:`param-country-code`,children:_jsxs(_components.p,{children:[`Available to session/Bearer callers only; not accepted with `,_jsx(_components.code,{children:`x-api-key`}),`. Use `,_jsx(_components.code,{children:`GLOBAL`}),` for a random popular region or a two-letter ISO code such as `,_jsx(_components.code,{children:`FR`}),` to prefer a trusted proxy in that region with dynamic fallback. An empty string is not a valid selection. Cannot be combined with `,_jsx(_components.code,{children:`proxy`}),` in the same request. This override affects this run only and does not update the saved profile.`]})}),`\n`,_jsx(ParamField,{body:`cookies`,type:`array`,id:`param-cookies`,children:_jsx(_components.p,{children:`Optional per-run cookie override. Takes precedence over any cookies saved in the profile for this run only, without updating the saved profile configuration.`})}),`\n`,_jsx(ParamField,{body:`fingerprint`,type:`object`,id:`param-fingerprint`,children:_jsxs(_components.p,{children:[`Optional per-run fingerprint override, merged by field with saved settings for this run only. Supported fields: `,_jsx(_components.code,{children:`webRtc`}),` (`,_jsx(_components.code,{children:`forward`}),` | `,_jsx(_components.code,{children:`real`}),` | `,_jsx(_components.code,{children:`disabled`}),`), `,_jsx(_components.code,{children:`webGl`}),` / `,_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:`random`}),` | `,_jsx(_components.code,{children:`real`}),`), `,_jsx(_components.code,{children:`webGpu`}),` (`,_jsx(_components.code,{children:`random`}),` | `,_jsx(_components.code,{children:`real`}),` | `,_jsx(_components.code,{children:`disabled`}),`), `,_jsx(_components.code,{children:`doNotTrack`}),` (`,_jsx(_components.code,{children:`random`}),` | `,_jsx(_components.code,{children:`enabled`}),` | `,_jsx(_components.code,{children:`disabled`}),`). Legacy `,_jsx(_components.code,{children:`hardwareConcurrency`}),` and `,_jsx(_components.code,{children:`deviceMemory`}),` accept integers 1–64. Invalid or conflicting combinations return `,_jsx(_components.code,{children:`INVALID_FINGERPRINT_SETTINGS`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),` on success.`]})}),`\n`,_jsxs(ResponseField,{name:`runtime`,type:`object`,id:`param-runtime`,children:[_jsx(_components.p,{children:`Runtime state at confirmation.`}),_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:`200`}),` 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.`})})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Billing runs at `,_jsx(_components.strong,{children:`1 credit per started minute`}),` from a successful `,_jsx(_components.code,{children:`200`}),` response until you confirm stop via `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),`. Closing the viewer tab or losing the connection does `,_jsx(_components.strong,{children:`not`}),` stop billing.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:`Browser is running. Billing has started.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PROXY_REQUIRED`}),` (missing top-level proxy for API key), `,_jsx(_components.code,{children:`INVALID_PROXY`}),`, `,_jsx(_components.code,{children:`COUNTRY_PROXY_CONFLICT`}),` (`,_jsx(_components.code,{children:`proxy`}),` and `,_jsx(_components.code,{children:`countryCode`}),` both supplied), `,_jsx(_components.code,{children:`INVALID_COUNTRY_CODE`}),`, `,_jsx(_components.code,{children:`INVALID_FINGERPRINT_SETTINGS`}),`, or invalid cookies. A missing or inactive `,_jsx(_components.code,{children:`apiKeyId`}),` when using session/Bearer auth also returns `,_jsx(_components.code,{children:`400`}),`.`]})]}),_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`}),` (no active paid plan) or `,_jsx(_components.code,{children:`INSUFFICIENT_CREDITS`}),` (fewer than one credit available). The response includes `,_jsx(_components.code,{children:`balance`}),` and `,_jsx(_components.code,{children:`requiredCredits`}),` fields.`]})]}),_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.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`The profile does not exist or belongs to another user.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLOUD_BROWSER_CONCURRENCY_LIMIT`}),`: your running allowance is full or set to `,_jsx(_components.code,{children:`0`}),`. Stop another browser to free a slot before retrying. The response includes `,_jsx(_components.code,{children:`runningLimit`}),` and `,_jsx(_components.code,{children:`runningCount`}),`. Or the browser is already running (no code): this profile already has an active session in `,_jsx(_components.code,{children:`starting`}),`, `,_jsx(_components.code,{children:`running`}),`, or `,_jsx(_components.code,{children:`stopping`}),` state. Stop it first, wait for `,_jsx(_components.code,{children:`stopped`}),`, then start again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLOUD_RUNTIME_AUTH_FAILED`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_NOT_FOUND`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_HTTP_ERROR`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_INVALID_RESPONSE`}),`, or `,_jsx(_components.code,{children:`CLOUD_RUNTIME_CONTROLLER_FAILED`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLUSTER_NO_CAPACITY`}),` (includes nullable `,_jsx(_components.code,{children:`nextAvailableAt`}),` and `,_jsx(_components.code,{children:`retryAfterMs`}),`), `,_jsx(_components.code,{children:`CDP session capacity exhausted`}),`, `,_jsx(_components.code,{children:`MANAGED_PROXY_UNAVAILABLE`}),`, `,_jsx(_components.code,{children:`DYNAMIC_PROXY_NOT_CONFIGURED`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_UNREACHABLE`}),`, or `,_jsx(_components.code,{children:`CLOUD_RUNTIME_CONFIG_INVALID`}),`. A proxy failure never falls back to a direct connection; fix the proxy before retrying.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`504`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLOUD_RUNTIME_TIMEOUT`}),`. A timeout does not prove the runtime is absent. Inspect the profile’s status and call stop when needed; the running slot remains reserved until cleanup is confirmed.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Internal service failure.`})]})]})]})]})}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":"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"}}},"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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,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);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Start a previously saved cloud browser profile by its `,_jsx(_components.code,{children:`id`}),`. The endpoint blocks until the browser reaches `,_jsx(_components.code,{children:`running`}),` state and then returns `,_jsx(_components.code,{children:`200`}),` with the full runtime object, including `,_jsx(_components.code,{children:`connectUrl`}),`, so you can open the interactive session immediately. A successful `,_jsx(_components.code,{children:`200`}),` response means billing has begun: credits are consumed at one credit per started minute from this moment until you call `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),`.`]}),`\n`,_jsx(ParamField,{path:`id`,type:`string (UUID)`,required:true,id:`param-id`,children:_jsxs(_components.p,{children:[`The persistent profile identifier returned by `,_jsx(_components.code,{children:`POST /cloud-browsers`}),` (create) or `,_jsx(_components.code,{children:`GET /cloud-browsers`}),` (list). This is distinct from the runtime `,_jsx(_components.code,{children:`sessionId`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`proxy`,type:`object`,required:true,id:`param-proxy`,children:[_jsxs(_components.p,{children:[`Required on every `,_jsx(_components.code,{children:`x-api-key`}),` start. You must supply a valid top-level `,_jsx(_components.code,{children:`proxy`}),` on each start request even if a proxy was saved in the profile’s `,_jsx(_components.code,{children:`browserSettings`}),`. A saved proxy, a managed `,_jsx(_components.code,{children:`countryCode`}),`, or a previous run’s proxy cannot satisfy this requirement.`]}),_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. Start overrides affect this run only and do not update the saved profile.`]})]}),`\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`}),`. Select an active, unexpired API key that belongs to your account. When authenticating with `,_jsx(_components.code,{children:`x-api-key`}),`, the current key is selected automatically; if `,_jsx(_components.code,{children:`apiKeyId`}),` is also provided, it must match.`]})}),`\n`,_jsx(ParamField,{body:`countryCode`,type:`string`,id:`param-country-code`,children:_jsxs(_components.p,{children:[`Available to session/Bearer callers only; not accepted with `,_jsx(_components.code,{children:`x-api-key`}),`. Use `,_jsx(_components.code,{children:`GLOBAL`}),` for a random popular region or a two-letter ISO code such as `,_jsx(_components.code,{children:`FR`}),` to prefer a trusted proxy in that region with dynamic fallback. An empty string is not a valid selection. Cannot be combined with `,_jsx(_components.code,{children:`proxy`}),` in the same request. This override affects this run only and does not update the saved profile.`]})}),`\n`,_jsx(ParamField,{body:`cookies`,type:`array`,id:`param-cookies`,children:_jsx(_components.p,{children:`Optional per-run cookie override. Takes precedence over any cookies saved in the profile for this run only, without updating the saved profile configuration.`})}),`\n`,_jsx(ParamField,{body:`fingerprint`,type:`object`,id:`param-fingerprint`,children:_jsxs(_components.p,{children:[`Optional per-run fingerprint override, merged by field with saved settings for this run only. Supported fields: `,_jsx(_components.code,{children:`webRtc`}),` (`,_jsx(_components.code,{children:`forward`}),` | `,_jsx(_components.code,{children:`real`}),` | `,_jsx(_components.code,{children:`disabled`}),`), `,_jsx(_components.code,{children:`webGl`}),` / `,_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:`random`}),` | `,_jsx(_components.code,{children:`real`}),`), `,_jsx(_components.code,{children:`webGpu`}),` (`,_jsx(_components.code,{children:`random`}),` | `,_jsx(_components.code,{children:`real`}),` | `,_jsx(_components.code,{children:`disabled`}),`), `,_jsx(_components.code,{children:`doNotTrack`}),` (`,_jsx(_components.code,{children:`random`}),` | `,_jsx(_components.code,{children:`enabled`}),` | `,_jsx(_components.code,{children:`disabled`}),`). Legacy `,_jsx(_components.code,{children:`hardwareConcurrency`}),` and `,_jsx(_components.code,{children:`deviceMemory`}),` accept integers 1–64. Invalid or conflicting combinations return `,_jsx(_components.code,{children:`INVALID_FINGERPRINT_SETTINGS`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`ok`,type:`boolean`,id:`param-ok`,children:_jsxs(_components.p,{children:[`Always `,_jsx(_components.code,{children:`true`}),` on success.`]})}),`\n`,_jsxs(ResponseField,{name:`runtime`,type:`object`,id:`param-runtime`,children:[_jsx(_components.p,{children:`Runtime state at confirmation.`}),_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:`200`}),` 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.`})})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Billing runs at `,_jsx(_components.strong,{children:`1 credit per started minute`}),` from a successful `,_jsx(_components.code,{children:`200`}),` response until you confirm stop via `,_jsx(_components.code,{children:`POST /cloud-browsers/{id}/stop`}),`. Closing the viewer tab or losing the connection does `,_jsx(_components.strong,{children:`not`}),` stop billing.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{children:`Browser is running. Billing has started.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`PROXY_REQUIRED`}),` (missing top-level proxy for API key), `,_jsx(_components.code,{children:`INVALID_PROXY`}),`, `,_jsx(_components.code,{children:`COUNTRY_PROXY_CONFLICT`}),` (`,_jsx(_components.code,{children:`proxy`}),` and `,_jsx(_components.code,{children:`countryCode`}),` both supplied), `,_jsx(_components.code,{children:`INVALID_COUNTRY_CODE`}),`, `,_jsx(_components.code,{children:`INVALID_FINGERPRINT_SETTINGS`}),`, or invalid cookies. A missing or inactive `,_jsx(_components.code,{children:`apiKeyId`}),` when using session/Bearer auth also returns `,_jsx(_components.code,{children:`400`}),`.`]})]}),_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`}),` (no active paid plan) or `,_jsx(_components.code,{children:`INSUFFICIENT_CREDITS`}),` (fewer than one credit available). The response includes `,_jsx(_components.code,{children:`balance`}),` and `,_jsx(_components.code,{children:`requiredCredits`}),` fields.`]})]}),_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.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:`The profile does not exist or belongs to another user.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLOUD_BROWSER_CONCURRENCY_LIMIT`}),`: your running allowance is full or set to `,_jsx(_components.code,{children:`0`}),`. Stop another browser to free a slot before retrying. The response includes `,_jsx(_components.code,{children:`runningLimit`}),` and `,_jsx(_components.code,{children:`runningCount`}),`. Or the browser is already running (no code): this profile already has an active session in `,_jsx(_components.code,{children:`starting`}),`, `,_jsx(_components.code,{children:`running`}),`, or `,_jsx(_components.code,{children:`stopping`}),` state. Stop it first, wait for `,_jsx(_components.code,{children:`stopped`}),`, then start again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLOUD_RUNTIME_AUTH_FAILED`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_NOT_FOUND`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_HTTP_ERROR`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_INVALID_RESPONSE`}),`, or `,_jsx(_components.code,{children:`CLOUD_RUNTIME_CONTROLLER_FAILED`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLUSTER_NO_CAPACITY`}),` (includes nullable `,_jsx(_components.code,{children:`nextAvailableAt`}),` and `,_jsx(_components.code,{children:`retryAfterMs`}),`), `,_jsx(_components.code,{children:`CDP session capacity exhausted`}),`, `,_jsx(_components.code,{children:`MANAGED_PROXY_UNAVAILABLE`}),`, `,_jsx(_components.code,{children:`DYNAMIC_PROXY_NOT_CONFIGURED`}),`, `,_jsx(_components.code,{children:`CLOUD_RUNTIME_UNREACHABLE`}),`, or `,_jsx(_components.code,{children:`CLOUD_RUNTIME_CONFIG_INVALID`}),`. A proxy failure never falls back to a direct connection; fix the proxy before retrying.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`504`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`CLOUD_RUNTIME_TIMEOUT`}),`. A timeout does not prove the runtime is absent. Inspect the profile’s status and call stop when needed; the running slot remains reserved until cleanup is confirmed.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`500`}),_jsx(_components.td,{children:`Internal service failure.`})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL (API Key with Proxy)`,numberOfLines:`11`,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:`11`,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:` 65`}),_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/\u003cbrowser-id>/start'`}),_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:`}'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL (Session / Bearer with countryCode)`,numberOfLines:`8`,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:`8`,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:` 65`}),_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/\u003cbrowser-id>/start'`}),_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:` 'Authorization: Bearer \u003cSESSION_JWT>'`}),_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:` \"apiKeyId\": \"\u003capi-key-id>\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"countryCode\": \"GLOBAL\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`}'`})}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200 Running (neko)`,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"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:` \"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:`400 Proxy Required`,numberOfLines:`4`,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:`4`,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:`\"API key starts require an explicit proxy in every request\"`}),_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:`\"PROXY_REQUIRED\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`409 Concurrency Limit`,numberOfLines:`4`,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:`4`,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 running limit reached\"`}),_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_BROWSER_CONCURRENCY_LIMIT\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`503 No Capacity`,numberOfLines:`6`,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:`6`,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 cluster has no available capacity\"`}),_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:`\"CLUSTER_NO_CAPACITY\"`}),_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:` \"nextAvailableAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_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:` \"retryAfterMs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\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":"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"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL (API Key with Proxy)","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=\"11\">\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\"> 65\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/\u0026#x3C;browser-id>/start'\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\">}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL (Session / Bearer with countryCode)","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=\"8\">\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\"> 65\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/\u0026#x3C;browser-id>/start'\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\"> 'Authorization: Bearer \u0026#x3C;SESSION_JWT>'\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\"> \"apiKeyId\": \"\u0026#x3C;api-key-id>\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"countryCode\": \"GLOBAL\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200 Running (neko)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"10\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"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\"> \"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":"400 Proxy Required","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=\"4\">\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\">\"API key starts require an explicit proxy in every request\"\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\">\"PROXY_REQUIRED\"\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":"409 Concurrency Limit","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=\"4\">\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 running limit reached\"\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_BROWSER_CONCURRENCY_LIMIT\"\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":"503 No Capacity","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=\"6\">\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 cluster has no available capacity\"\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\">\"CLUSTER_NO_CAPACITY\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"nextAvailableAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"retryAfterMs\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\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":"Start Cloud Browser","path":"/cloud-browsers/{id}/start","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":{"id":{"schema":[{"type":"object","properties":{},"description":"The persistent profile identifier returned by `POST /cloud-browsers` (create) or `GET /cloud-browsers` (list). This is distinct from the runtime `sessionId` .","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"proxy":[{"type":"object","properties":{},"description":"Required on every `x-api-key` start. You must supply a valid top-level `proxy` on each start request even if a proxy was saved in the profile’s `browserSettings` . A saved proxy, a managed `countryCode` , or a previous run’s proxy cannot satisfy this requirement. 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. Start overrides affect this run only and do not update the saved profile.","required":true}],"apiKeyId":[{"type":"object","properties":{},"description":"Required when authenticating with a session cookie or `Authorization: Bearer` . Select an active, unexpired API key that belongs to your account. When authenticating with `x-api-key` , the current key is selected automatically; if `apiKeyId` is also provided, it must match."}],"countryCode":[{"type":"string","description":"Available to session/Bearer callers only; not accepted with `x-api-key` . Use `GLOBAL` for a random popular region or a two-letter ISO code such as `FR` to prefer a trusted proxy in that region with dynamic fallback. An empty string is not a valid selection. Cannot be combined with `proxy` in the same request. This override affects this run only and does not update the saved profile."}],"cookies":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Optional per-run cookie override. Takes precedence over any cookies saved in the profile for this run only, without updating the saved profile configuration."}],"fingerprint":[{"type":"object","properties":{},"description":"Optional per-run fingerprint override, merged by field with saved settings for this run only. Supported fields: `webRtc` ( `forward` | `real` | `disabled` ), `webGl` / `webGlImage` / `canvas` / `audioContext` / `clientRects` / `speechVoices` / `fonts` / `hardware` ( `random` | `real` ), `webGpu` ( `random` | `real` | `disabled` ), `doNotTrack` ( `random` | `enabled` | `disabled` ). Legacy `hardwareConcurrency` and `deviceMemory` accept integers 1–64. Invalid or conflicting combinations return `INVALID_FINGERPRINT_SETTINGS` ."}]}}],"examples":{"example":{"value":{"proxy":{},"apiKeyId":{},"countryCode":"\u003cstring>","cookies":[{}],"fingerprint":{}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"ok":[{"type":"boolean","description":"Always `true` on success."}],"runtime":[{"type":"object","properties":{"runtimeKind":[{"type":"string","description":"`neko` or `worker_cdp` . `neko` omits `cdpBaseUrl` ."}],"status":[{"type":"string","description":"Always `\"running\"` in a successful `200` 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."}]},"description":"Runtime state at confirmation."}]}}],"examples":{"example":{"value":{"ok":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":"Start Cloud Browser - AdsCrawl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/cloud-browsers-start","matchLevel":0},"zh":{"href":"/zh/api-reference/cloud-browsers-start","matchLevel":1}}},"lastModified":"2026-09-29T03:36:15.473Z","originalFileLocation":"api-reference/cloud-browsers-start.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=\"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.\">\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=\"Start Cloud Browser - AdsCrawl\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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-start\">\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=Start+Cloud+Browser\u0026amp;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.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=a5aad6db80c565b6797d676fdfdcf1241693ed2923182bc5258b47f63af947b0\">\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=\"Start Cloud Browser - AdsCrawl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adscrawl.mintlify.site/_mintlify/api/og/v2?division=Cloud+Browsers\u0026amp;title=Start+Cloud+Browser\u0026amp;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.\u0026amp;theme=77f75d39b9b0c121a2092b55\u0026amp;signature=a5aad6db80c565b6797d676fdfdcf1241693ed2923182bc5258b47f63af947b0\">\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-start\">\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-start.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.adscrawl.net/api-reference/cloud-browsers-start\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.adscrawl.net/zh/api-reference/cloud-browsers-start\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.adscrawl.net/api-reference/cloud-browsers-start\">\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-start#webpage\",\"url\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start\",\"name\":\"Start Cloud 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.\",\"dateModified\":\"2026-09-29T03:36:15.473Z\",\"isPartOf\":{\"@id\":\"https://docs.adscrawl.net#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloud Browsers\",\"item\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Start Cloud Browser\",\"item\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start#apireference\",\"headline\":\"Start Cloud Browser\",\"name\":\"Start Cloud 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.\",\"url\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adscrawl.net/api-reference/cloud-browsers-start#webpage\"},\"dateModified\":\"2026-09-29T03:36:15.473Z\",\"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-start.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","api":"POST /cloud-browsers","playground":"interactive","href":"/api-reference/cloud-browsers-create"},{"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"},{"title":"Start Cloud Browser","sidebarTitle":"Start Browser","api":"POST /cloud-browsers/{id}/start","playground":"interactive","href":"/api-reference/cloud-browsers-start"},{"title":"Stop Cloud Browser","sidebarTitle":"Stop Browser","description":"Stop a running cloud browser, end billing, and release the concurrent running slot. The saved profile is retained for future restarts.","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-start"}]}]},"basePath":"","title":"Start Cloud 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"]}