API reference

Solve a captcha

One authenticated POST returns a token. Authenticate with your API key in the x-api-key header. Only successful solves are billed.

Endpoint

POSThttps://api.kagedcap.io/solve
Request body
{
  "task": "ReCaptchaV3EnterpriseTask",
  "url": "https://www.ticketmaster.com",
  "sitekey": "6LcvL3UrAAAAAO_9u8Seiuf-I6F_tP_jSS-zndXV",
  "action": "Event",
  "proxy": "http://user:pass@1.2.3.4:8888",
  "enhanced": false
}
200 response
{
  "success": true,
  "task": "ReCaptchaV3EnterpriseTask",
  "token": "0cAFcWeA…",
  "score": 0.9,
  "verification": null
}

Supported tasks: ReCaptchaV3Task, ReCaptchaV3TaskProxyLess, ReCaptchaV3EnterpriseTask, ReCaptchaV3EnterpriseTaskProxyLess. ProxyLess tasks must omit proxy; the others require it.

Check balance

GEThttps://api.kagedcap.io/v1/balance
200 response
{ "available_micros": "2998000", "display": "$2.998" }

SDKs

Official clients for five languages — each handles auth, task selection, and errors.

All repos on GitHub ↗
TypeScriptnpm install @kagedcap/sdk
GitHub ↗
import { KagedCapClient } from '@kagedcap/sdk';
const kc = new KagedCapClient(process.env.KAGEDCAP_API_KEY!);
const { token } = await kc.solve({ sitekey, url, action, enterprise: true });
Node.jsnpm install kagedcap
GitHub ↗
const { KagedCapClient } = require('kagedcap');
const kc = new KagedCapClient(process.env.KAGEDCAP_API_KEY);
const { token } = await kc.solve({ sitekey, url, action, enterprise: true });
Pythonpip install kagedcap
GitHub ↗
from kagedcap import KagedCapClient
kc = KagedCapClient(api_key)
res = kc.solve(sitekey=…, url=…, action="login", enterprise=True)
Gogo get github.com/KagedCap/kagedcap-sdk-go
GitHub ↗
kc := kagedcap.New(apiKey)
res, err := kc.Solve(kagedcap.SolveParams{Sitekey: …, URL: …, Action: "login", Enterprise: true})
Rustcargo add kagedcap
GitHub ↗
let kc = KagedCapClient::new(api_key);
let res = kc.solve(SolveParams { sitekey, url, action, enterprise: true, ..Default::default() })?;

Errors

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
400validation_errorBad request shape (see message).
400proxy_required / proxy_not_allowedProxy present/absent for the wrong task.
402insufficient_fundsTop up your balance.
429concurrency_limit_exceededToo many concurrent solves.
502solve_failedThe solve failed (not billed).
504solve_timeoutThe solve timed out (not billed).