CAPTCHA handling

Cloud browsers solve supported CAPTCHA challenges automatically.

Automatic CAPTCHA solving is enabled by default for API V4 Agent runs and standalone Cloud Browser sessions.

For a standalone browser created with POST /api/v4/browsers, set "solveCaptchas": false to handle challenges yourself. This standalone-browser field is not currently part of V4 run browserSettings.

The automatic solver handles CAPTCHAs. Cloudflare and other bot walls are handled by the browser’s stealth layer and residential proxies, not by the CAPTCHA solver.

Other anti-bot pages may still be passed by the browser’s stealth protections or residential proxy. That is separate from automatic CAPTCHA solver coverage.

When a CAPTCHA appears

Stop driving the page, wait about 10 seconds, then inspect it again. Do not refresh, click the challenge, or replace the browser while the solver is working.

CAPTCHA solving is not guaranteed. If the challenge remains, open the live preview for human control. If the whole site is blocking the browser rather than showing a challenge, try a different proxy country.

For a specific CAPTCHA or anti-bot issue, email [e-mail].