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
captchaSolver	object	No	Optional runtime configuration.
enabled	boolean	When captchaSolver is non-empty	Enables or disables CAPTCHA Solver.
types.recaptchaV2	boolean	When captchaSolver is non-empty	Enables reCAPTCHA v2.
types.recaptchaV3	boolean	When captchaSolver is non-empty	Enables reCAPTCHA v3.
types.textCaptcha	boolean	When captchaSolver is non-empty	Enables image-to-text CAPTCHA recognition.
types.awsCaptcha	boolean	When captchaSolver is non-empty	Enables supported AWS CAPTCHA image challenges.
types.cloudflareTurnstile	boolean	When captchaSolver is non-empty	Enables Cloudflare Turnstile widgets.

When captchaSolver is provided, send enabled and all five types fields. Use {} or omit the field to inherit saved Profile or Group settings for an existing Profile. If 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.

For existing Profile launch APIs, malformed optional runtime overrides may be ignored and the saved settings used. Send a complete object to avoid fallback.

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. 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 {} leaves CAPTCHA Solver disabled 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.

POST /api/v2/browsers?config=URL_ENCODED_CONFIGURATION

["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