Providers Overview

uCaptcha aggregates six CAPTCHA solving providers behind a single unified API. You do not need to sign up with any individual provider — uCaptcha handles all provider API keys, billing, and communication on your behalf.

How It Works

When you submit a task to the uCaptcha API, the Smart Routing algorithm evaluates all available providers and selects the best one based on your speed, cost, and reliability preferences. The entire process is transparent — you interact with one API and receive results regardless of which provider solved the task.

Key Benefits

• Single API — One integration covers all providers and task types. No need to build adapters for each provider.
• Automatic failover — If one provider goes down, tasks are routed to healthy alternatives without any action on your part.
• Real-time health monitoring — Provider status, average solve time, and success rate are tracked continuously.
• No provider accounts needed — uCaptcha manages provider credentials. You only need a uCaptcha API key.
• Hot-reloadable — New providers can be added to the platform without downtime or API changes.

Provider Health

Each provider is monitored in real time and assigned a health status based on its recent success rate:

Status	Success Rate	Description
Online	> 80%	Provider is healthy and accepting tasks normally
Degraded	50-80%	Provider is experiencing issues; tasks may be slower or less reliable
Offline	< 50%	Provider is down or severely impaired; tasks will be routed elsewhere

The routing algorithm factors health status into scoring. Degraded and offline providers receive lower reliability scores, making them less likely to be selected unless no better alternative exists.

Forcing a Provider

If you need to send a task to a specific provider (for testing, comparison, or preference), use the provider parameter in your createTask request:

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV2TokenProxyLess",
    "websiteURL": "https://example.com",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
  },
  "provider": "capsolver"
}

Caution

Forcing a provider bypasses all routing logic, including health checks. If the specified provider is offline or does not support the task type, the request will fail.

Bring Your Own Keys

If you already have API keys with one or more providers, you can submit them through Key Recycling to earn uCaptcha credits. Your keys enter the routing pool and are used to solve tasks, with each solve credited to your balance dollar-for-dollar.

Provider Transparency

The getTaskResult response includes a provider field indicating which provider solved the task. This is useful for debugging, cost analysis, and verifying that routing is working as expected.

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq24..."
  },
  "provider": "capsolver"
}

See Supported Providers for a full list of providers and their capabilities.