Cloudflare Interstitial Solver API

The Solverify Cloudflare Interstitial Solver API creates a browser-based task for Cloudflare interstitial challenges and returns cf_clearance cookies. Use this task type when your integration needs cookies, the solver user-agent, and optionally the post-challenge HTML.

Request Parameters

Field	Required	Description
`clientKey`	Yes	Your API key.
`websiteURL`	Yes	Full URL of the target page.
`useragent`	No	User-agent string to use. Recommended for matching your follow-up request.
`source`	No	If `true`, returns post-challenge HTML in `solution.html`.
`method`	No	Navigation method. Allowed values: `GET`, `POST`. Default: `GET`.
`proxyType`	Yes	Proxy type. Only `http` is accepted.
`proxyAddress`	Yes	Proxy IP address or hostname.
`proxyPort`	Yes	Proxy port. Numeric string, 1 to 5 digits.
`proxyLogin`	No	Proxy username.
`proxyPassword`	No	Proxy password.

The proxy and user-agent should match the request where you use the returned cf_clearance cookie.

If you provide useragent, use a desktop Chrome or Chromium user-agent. Firefox, Edge, Opera, iOS, and Android user-agents are rejected.

Create Task Example

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "interstitial",
    "websiteURL": "https://example.com",
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
    "source": true,
    "method": "GET",
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "80",
    "proxyLogin": "username",
    "proxyPassword": "password"
  }
}

Create Response

{
  "errorId": 0,
  "taskId": "UUID"
}

Result Example

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "dce6748725944f29b43b64a5eaad3a",
    "cookies": {
      "cf_clearance": ".AdOHyy60coo8q0wL6TAJFu2V1"
    },
    "useragent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
    "html": "<html>...</html>"
  },
  "errorCode": null,
  "errorDescription": null
}

html is only present when source is true and the page HTML was captured.

Timeout

Cloudflare Interstitial tasks can run for up to about 120 seconds before timing out internally.

Next Steps

After creating a Cloudflare Interstitial task, poll the Get Task Result API with the returned taskId. For validation and capacity errors, see Solverify API Error Codes.