Solvers

Cloudflare Clearance

How to solve Cloudflare Clearance challenges with the Astrum Solver API: parameters, request and response.

Interstitial page check. Returns the clearance cookie bound to your proxy IP and user agent.

Field	Value
type	cf_clearance
Vendor	Cloudflare
Solution	cf_clearance cookie

Parameters

These fields go inside the task object of a createTask request. Optional fields are only needed when the target page supplies them.

Name	Type	Description
websiteURL	stringrequired	Page that serves the challenge. Must be https and resolve to a public address.
proxyURL	stringrequired	Proxy the challenge is solved through, as http://login:password@host:port. The solution is bound to this exit IP.
userAgent	stringoptional	User agent to solve with. Send the same one you will replay the solution with.

Create a task

POSThttps://solver-dev.astrum.foundation/api/createTask

Payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "cf_clearance",
    "websiteURL": "https://target.com/login",
    "proxyURL": "http://login:password@host:port"
  }
}

Response

{"errorId": 0, "taskId": "6f1c8b32-0a5e-4a19-9a1f-3b0d54c2a1e7"}

With optional fields

createTask payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "cf_clearance",
    "websiteURL": "https://target.com/login",
    "proxyURL": "http://login:password@host:port",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36"
  }
}

Collect the solution

Poll every few seconds. Until the task closes the response carries only a status; the solution appears once it does.

POSThttps://solver-dev.astrum.foundation/api/getTaskResult

Payload

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "taskId": "6f1c8b32-0a5e-4a19-9a1f-3b0d54c2a1e7",
    "type": "cf_clearance"
  }
}

Response

{"errorId": 0, "status": "closed", "solution": {"token": "…"}}

The solution is bound to the proxy that produced it. Replay it from the same exit IP, and from the same user agent when you sent one.