POST /v1/solve
POST
/v1/solveSolve 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
| Field | Type | Description |
|---|---|---|
typerequired | string | akamai.sbsd, akamai.sbsd.payload or cloudflare.jsd. Anything else returns unsupported_type. akamai.sbsd.payload takes different fields, see its page. |
urlrequired | string | A page behind the protection. Its domain must be approved. |
proxystrongly advised | string | http://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. |
userAgent | string | Optional, 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
| Field | Type | Description |
|---|---|---|
ok | boolean | Always true on a 200. |
requestId | string | Quote it to support. Also sent as the x-request-id header, on errors too. |
result | object | Depends on type: Akamai SBSD, Akamai SBSD payload, Cloudflare JSD. |
cost | number | Euros charged. 0 if nothing was charged. |
costMicro | integer | The same in millionths of a euro, for exact sums. |
solveMs | integer | Solve 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:
{
"error": {
"code": "insufficient_balance",
"message": "Not enough balance. Top up at notabot.sh/app/billing"
},
"requestId": "req_Qm3x…"
}All codes: Errors.