Dashboard

API Docs

v0.1.0
Info

Base URL

http://localhost:8199

Auth: header X-Gateway-Token (opsional)

Provider Support

Provider mana yang support apa?

FeatureCapsolver2CaptchaAntiCaptcha
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": {}
}
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_typebody =website_url
ImageToTextTaskBase64 gambar
ReCaptchaV2TaskProxyLessSite key Wajib
ReCaptchaV3TaskProxyLessSite key Wajib
HCaptchaTaskProxyLessSite key Wajib
TurnstileTaskProxyLessSite key Wajib
FunCaptchaTaskProxyLessPublic key Wajib
GeeTestTaskProxyLessGT 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}
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

Background

Auto-Hunter

Key baru otomatis dicari dari GitHub tiap 30 menit:

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

Errors

HTTP Status Codes