Configuration

CAPTCHA Solver is configured through the optional captchaSolver object.

Configuration Object

{
  "captchaSolver": {
    "enabled": true,
    "types": {
      "recaptchaV2": true,
      "recaptchaV3": true,
      "textCaptcha": true,
      "awsCaptcha": true,
      "cloudflareTurnstile": true
    }
  }
}

Field	Type	Required	Description
`enabled`	boolean	Yes	Enables or disables CAPTCHA Solver.
`types.recaptchaV2`	boolean	Yes	Enables reCAPTCHA v2, including Enterprise websites.
`types.recaptchaV3`	boolean	Yes	Enables reCAPTCHA v3, including Enterprise websites.
`types.textCaptcha`	boolean	Yes	Enables image-to-text CAPTCHA recognition.
`types.awsCaptcha`	boolean	Yes	Enables supported AWS CAPTCHA image challenges.
`types.cloudflareTurnstile`	boolean	Yes	Enables Cloudflare Turnstile widgets.

A non-empty captchaSolver object must be complete. StartOnceBrowser, ConnectBrowser, and ConnectOnceBrowser reject partial objects, unknown fields, and non-boolean values. For the existing-Profile start APIs (StartBrowser and StartBrowsers), an invalid optional runtime override is ignored and the saved Profile or Group configuration is used for backward compatibility.

When enabled is true, at least one CAPTCHA type must also be enabled.

To explicitly disable CAPTCHA Solver, send the complete object with enabled set to false.

Start a Saved Profile

Use POST /api/v2/browsers/{profileId} to override the saved Profile configuration for the current launch.

Omit captchaSolver or send an empty object to use the saved Profile or Group configuration:

{
  "captchaSolver": {}
}

The browser must be stopped before starting it with a different runtime configuration.

Start a Once Browser

Use POST /api/v2/browsers/once and include captchaSolver in the browser configuration.

Once Browsers do not inherit Profile or Group settings. Omitting captchaSolver or sending {} disables CAPTCHA Solver for that Once Browser.

Connect Through a CDP Endpoint

For ConnectBrowser and ConnectOnceBrowser, include the complete browser configuration in the URL-encoded config query parameter.

For ConnectOnceBrowser, remove /PROFILE_ID from the endpoint.

If ConnectBrowser connects to an already running browser, the new CAPTCHA Solver configuration is not applied. Stop the browser and reconnect to start it with the new configuration.

Start Multiple Profiles

StartBrowsers keeps the Profile ID array as its request body. Pass the shared CAPTCHA Solver configuration through the URL-encoded config query parameter.

[
  "PROFILE_ID_1",
  "PROFILE_ID_2"
]

The same runtime CAPTCHA configuration is applied to every Profile in that request.

Configuration Object#

Start a Saved Profile#

Start a Once Browser#

Connect Through a CDP Endpoint#

Start Multiple Profiles#

Configuration Object

Start a Saved Profile

Start a Once Browser

Connect Through a CDP Endpoint

Start Multiple Profiles