DocsGetting StartedQuickstart
Quickstart
Solve your first captcha
One request, one token back, at $0.69 per 1,000 solves. No proxy to supply — Scarnox infrastructure handles that side.
1. Make a request
bash
curl -X POST https://api.scarnox.com/api/tasks/create \
-H "Authorization: Bearer scarnox_YOURAPIKEY" \
-H "Content-Type: application/json" \
-d '{
"captcha_type": "PopularCaptchaTokenProxyless",
"site_key": "YOUR_SITEKEY",
"site_url": "https://your-site-url.com"
}'Using your own proxy
Switch captcha_type to PopularCaptchaToken and add a proxy. It is billed at $0.65/1k instead of $0.69/1k, because the solve does not use our proxy pool. Everything else — the response shape, the error codes — is identical.
bash
curl -X POST https://api.scarnox.com/api/tasks/create \
-H "Authorization: Bearer scarnox_YOURAPIKEY" \
-H "Content-Type: application/json" \
-d '{
"captcha_type": "PopularCaptchaToken",
"site_key": "YOUR_SITEKEY",
"site_url": "https://your-site-url.com",
"proxy": "http://user:pass@1.2.3.4:8080"
}'Which one should I use?
Use Proxyless unless you specifically need the solve to originate from your own IP — it is one less moving part and nothing to maintain. Use PopularCaptchaToken when the target site is sensitive to IP reputation or geography, or when you already run a proxy pool and want the lower rate.
2. Response
json
{
"errorId": 0,
"taskId": "scrx_1748350341234_ab12cd34",
"status": "ready",
"solution": {
"token": "P1_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
"challenge_type": "image_label_binary"
},
"cost": 0.00069,
"balance": 9.99935,
"createTime": 1748350341,
"endTime": 1748350349
}solution.token expires in ~120s — submit to the target site immediately. Check errorId === 0 before reading the token.