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.