SOP 013: Captchas API Reference

Fresh

Field	Value
SOP ID	SOP-013
Version	1.0
Status	Active
Source	Steel Captchas API

Overview

The Captchas API provides endpoints for checking CAPTCHA status and triggering solves within active sessions.

CAPTCHA Detection & Solving Flow

API Endpoints

Get CAPTCHA Status

Check detected CAPTCHAs in a session:

const captchas = await client.sessions.captchas.list(sessionId);
// Returns array of detected CAPTCHAs with status, type, taskId, pageId, url

Solve CAPTCHAs

// Solve ALL detected CAPTCHAs
await client.sessions.captchas.solve(sessionId);

// Solve by task ID
await client.sessions.captchas.solve(sessionId, { taskId: 'task_123' });

// Solve by URL
await client.sessions.captchas.solve(sessionId, { url: 'https://example.com' });

// Solve by page ID
await client.sessions.captchas.solve(sessionId, { pageId: 'page_123' });

Session Configuration

Auto-solving (default when enabled)

const session = await client.sessions.create({
  solveCaptcha: true
});

Detect-only mode (manual solving)

const session = await client.sessions.create({
  solveCaptcha: true,
  stealthConfig: {
    autoCaptchaSolving: false
  }
});

Supported CAPTCHA Types

Type	Status	Notes
ReCAPTCHA v2	Supported	Image and checkbox challenges
ReCAPTCHA v3	Supported	Score-based, invisible
Cloudflare Turnstile	Supported	Common on modern sites
ImageToText	Supported	Traditional image CAPTCHAs
Amazon AWS WAF	Supported	Bot detection challenges
GeeTest v3/v4	Coming Soon	Slider and click challenges
FunCAPTCHA	Not Supported	Arcade-style challenges

Verification Checklist

• [ ] solveCaptcha: true set on session
• [ ] CAPTCHA status endpoint returns detected CAPTCHAs
• [ ] Auto-solve resolves within reasonable time
• [ ] Manual solve endpoint triggers for specific CAPTCHAs
• [ ] Automation continues after solve

See Also

• SOP 004: CAPTCHA Solving
• SOP 003: Configure Proxies