Captcha Solving

Automatically solve CAPTCHAs during browser sessions. Browser Forest integrates with third-party captcha solving services so your automation flows never get stuck on verification challenges.

Supported Providers

We support multiple captcha solving providers. Configure your provider API key once and all sessions will use it automatically.

Solve a Captcha

Attach a captcha to a running session. The solver will detect and resolve the challenge automatically.

With Node.js SDK:

import { BrowserForest } from '@browser-forest/sdk';

const client = new BrowserForest({ apiKey: 'bf_live_xxxx' });

// Create a session and solve captcha on a page
const session = await client.sessions.create();
await client.captcha.solve({
  sessionId: session.id,
  url: 'https://example.com/login',
  captchaType: 'recaptcha_v2',   // optional, auto-detected
  timeout: 120,                   // optional, default 120s
});

// Continue with your automation...
await client.sessions.stop(session.id);

Direct API Call

Without SDK, you can call the captcha API directly:

curl -X POST https://bf.mktindex.com/api/v1/captcha/solve \
  -H "X-API-Key: bf_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "ses_xxxx",
    "url": "https://example.com/login",
    "captchaType": "recaptcha_v2",
    "timeout": 120
  }'

Response

On success:

{
  "success": true,
  "solvedAt": "2026-06-09T10:30:00Z",
  "provider": "capsolver",
  "captchaType": "recaptcha_v2",
  "durationMs": 8234
}

How It Works

Captcha solving happens synchronously within a session. When you post a captcha request, the worker:

1. Navigates to the target URL
2. Detects the captcha type (reCAPTCHA, hCaptcha, etc.)
3. Sends the challenge to the configured solving provider
4. Executes the solution token in the browser
5. Returns the solved status to your code

Request Parameters

Parameters for POST /v1/captcha/solve:

Error Handling

Common captcha solving errors:

Common Use Cases