notabotDocs

POST /v1/solve

POST/v1/solve

Solve one challenge. The call waits for the result: about 1 to 3 seconds for Cloudflare JSD and 2 to 10 for Akamai SBSD, depending mostly on how fast your proxy is.

Request body

Request body fields
FieldTypeDescription
typerequiredstringakamai.sbsd, akamai.sbsd.payload or cloudflare.jsd. Anything else returns unsupported_type. akamai.sbsd.payload takes different fields, see its page.
urlrequiredstringA page behind the protection. Its domain must be approved.
proxystrongly advisedstringhttp://user:pass@host:port. The cookies belong to this IP, so reuse the proxy afterwards. Without one we solve from our own server IP, which most sites reject.
userAgentstringOptional, up to 512 characters. Leave it out: the response tells you which user agent to use.

Other fields are dropped.

Examples

curl https://api.notabot.sh/v1/solve \
  -H "x-api-key: $NOTABOT_KEY" \
  -H "content-type: application/json" \
  -d '{
    "type": "akamai.sbsd",
    "url": "https://shop.example.com/",
    "proxy": "http://user:pass@host:port"
  }'

Response

Response fields
FieldTypeDescription
okbooleanAlways true on a 200.
requestIdstringQuote it to support. Also sent as the x-request-id header, on errors too.
resultobjectDepends on type: Akamai SBSD, Akamai SBSD payload, Cloudflare JSD.
costnumberEuros charged. 0 if nothing was charged.
costMicrointegerThe same in millionths of a euro, for exact sums.
solveMsintegerSolve time in milliseconds.
{
  "ok": true,
  "requestId": "req_Qm3x…",
  "result": {
    "cookies": { "_abck": "…", "bm_s": "…", "bm_sc": "…", "bm_so": "…" },
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36",
    "status": 200,
    "attempts": 1
  },
  "cost": 0.0025,
  "costMicro": 2500,
  "solveMs": 2140
}

When you are charged

Only on a 200. The price is held while the solve runs and released if it fails, so a failed call leaves your balance unchanged. Every error is free.

Errors

Errors share one shape, and the HTTP status matches the code:

402 Payment Required
{
  "error": {
    "code": "insufficient_balance",
    "message": "Not enough balance. Top up at notabot.sh/app/billing"
  },
  "requestId": "req_Qm3x…"
}

All codes: Errors.