Captcha Gateway — API Docs

Info

Base URL

http://localhost:8199

Auth: header X-Gateway-Token (opsional)

Provider Support

Provider mana yang support apa?

Feature	Capsolver	2Captcha	AntiCaptcha
reCAPTCHA v2
reCAPTCHA v3
hCaptcha
Turnstile (CF)
ImageToText
FunCaptcha
GeeTest v3/v4
AWS WAF
DataDome
CF Challenge
KeyCaptcha
Grid/Click

Recommendation: pakai provider: "auto" — gateway otomatis pilih key dengan balance terbanyak

Speed

CapSolver 1-5s 2Captcha 5-15s AntiCaptcha 5-15s

Endpoint

POST /v1/solve

Main endpoint. Kirim captcha task, terima solution.

{
  "provider": "auto",
  "task_type": "HCaptchaTaskProxyless",
  "body": "site-key-here",
  "website_url": "https://target.com",
  "extra": {}
}

provider — auto, capsolver, 2captcha, anticaptcha
task_type — captcha type (lihat tabel bawah)
body — base64 image (OCR) atau site key
website_url — URL halaman captcha

Response

Success:

{
  "success": true,
  "solution": "03AGdBq26...",
  "provider_used": "capsolver",
  "key_id": "CAP-F1E9..."
}

Error:

{
  "success": false,
  "error": "No available keys"
}

Task Types

task_type yang tersedia

task_type	body =	website_url
`ImageToTextTask`	Base64 gambar
`ReCaptchaV2TaskProxyless`	Site key	Wajib
`ReCaptchaV3TaskProxyless`	Site key	Wajib
`HCaptchaTaskProxyless`	Site key	Wajib
`TurnstileTaskProxyless`	Site key	Wajib
`FunCaptchaTaskProxyless`	Public key	Wajib
`GeeTestTaskProxyless`	GT key	Wajib

Endpoint

GET /v1/balance

Force-refresh balance semua key. Auto-disable key yang balance-nya $0.

curl http://localhost:8199/v1/balance

Response: list semua key + balance masing-masing

Endpoint

GET /v1/keys

List semua key di pool (tanpa hit provider API).

curl http://localhost:8199/v1/keys

Endpoint

POST /v1/keys/add

Tambah key baru ke pool. Auto-check balance saat add.

curl -X POST "http://localhost:8199/v1/keys/add\
  ?provider=capsolver\
  &api_key=CAP-XXXX"

Endpoint

POST /v1/keys/{key_id}/disable

Disable key tertentu.

curl -X POST http://localhost:8199/v1/keys/CAP-F1E9.../disable

Endpoint

GET /v1/stats

Gateway stats: total keys, balance, success rate, providers.

curl http://localhost:8199/v1/stats

Endpoint

GET /health

Quick health check.

{"status":"ok","keys":12,"active":12}

Endpoint

GET /v1/capabilities

Full capabilities matrix — all task types and providers.

curl http://localhost:8199/v1/capabilities

Returns list of all 30 supported task types, 18 providers, and per-provider type mappings.

Endpoint

GET /v1/capabilities/{task_type}

Which providers support a specific task type.

curl http://localhost:8199/v1/capabilities/HCaptchaTaskProxyless

Returns list of providers that can handle the given task_type.

Endpoint

GET /v1/capabilities/provider/{provider}

All task types supported by a specific provider.

curl http://localhost:8199/v1/capabilities/provider/capsolver

Returns list of task types the provider handles + API protocol used.

All 30 Task Types

Supported task_type values

ImageToTextTask RecaptchaV2Task RecaptchaV2TaskProxyless RecaptchaV3Task RecaptchaV3TaskProxyless RecaptchaV2EnterpriseTask RecaptchaV2EnterpriseTaskProxyless RecaptchaV3EnterpriseTask HCaptchaTask HCaptchaTaskProxyless HCaptchaEnterpriseTask HCaptchaEnterpriseTaskProxyless FunCaptchaTask FunCaptchaTaskProxyless TurnstileTask TurnstileTaskProxyless GeeTestTask GeeTestTaskProxyless GeeTestTaskV4 GeeTestTaskV4Proxyless DataDomeTask AWSWafTask MTCaptchaTask FriendlyCaptchaTask CyberSiaraTask TencentCaptchaTask BinanceCaptchaTask YidunCaptchaTask ImpervaTask CaptchaFoxTask

18 Providers

Provider → Task Type Matrix

Provider	Types	API
capsolver	27	createTask
2captcha	23	2captcha
rucaptcha	23	2captcha
yescaptcha	22	createTask
capmonster	20	createTask
anticaptcha	17	createTask
omocaptcha	17	createTask
solvecaptcha	13	createTask
anticaptcha_top	9	2captcha
azcaptcha	8	2captcha
freecaptchabypass	7	2captcha
jfbym	1	custom
deathbycaptcha	1	custom
truecaptcha	1	custom
nopecha	1	custom
imagetyperz	1	custom
endcaptcha	1	custom
bypasscaptcha	1	custom

Example

Solve hCaptcha

curl -X POST http://localhost:8199/v1/solve \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "auto",
    "task_type": "HCaptchaTaskProxyless",
    "body": "10000000-ffff-ffff-ffff-000000000001",
    "website_url": "https://example.com"
  }'

Example

Solve Image (OCR)

curl -X POST http://localhost:8199/v1/solve \
  -H "Content-Type: application/json" \
  -d '{
    "task_type": "ImageToTextTask",
    "body": "data:image/png;base64,iVBORw0K..."
  }'

Example

Solve reCAPTCHA v2

curl -X POST http://localhost:8199/v1/solve \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "capsolver",
    "task_type": "ReCaptchaV2TaskProxyless",
    "body": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "website_url": "https://google.com/recaptcha/demo"
  }'

Example

Python

import requests

resp = requests.post("http://localhost:8199/v1/solve", json={
    "provider": "auto",
    "task_type": "HCaptchaTaskProxyless",
    "body": "site-key-here",
    "website_url": "https://target.com"
})
token = resp.json()["solution"]

Logic

Key Rotation

Request masuk → filter enabled + balance > 0
Kalau ada provider → filter by provider
Round-robin selection (balance tertinggi diprioritaskan)
Success → +1 solve count
Error → +1 error count
Balance = 0 → auto-disable key

Background

Auto-Hunter

Key baru otomatis dicari dari GitHub tiap 30 menit:

Batch A 18 queries / 30min
Batch B 23 queries / 1jam
Batch C 30 queries / 90min

Target: repo obscure/low-star (lebih jarang di-revoke). Key live otomatis masuk gateway + report ke Telegram.

Errors

HTTP Status Codes

200 Success
422 Invalid request body
404 Key not found
503 No available keys
500 Provider API error