Solve Cloudflare Interstitial Task

Python ExamplesUpdated 12/25/2025

Use this task type to solve Cloudflare interstitial (challenge page) protections using a proxy.

NOTE: The proxy and user-agent should be same for both solver and your request code

Create an Interstitial task

task_id = api.solve_interstitial(
  site_url="https://example.com",
  user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
  proxy_type="http",
  proxy_address="1.1.1.1",
  proxy_port="80",
  proxy_login="username",
  proxy_password="password"
)

print(f"Interstitial Task ID: {task_id}")

Parameters

  • site_url — Target website URL
  • user_agent — User-Agent string (recommended)
  • proxy_type — Proxy type (http)
  • proxy_address — Proxy IP or hostname
  • proxy_port — Proxy port
  • proxy_login — Proxy username (optional)
  • proxy_password — Proxy password (optional)

Get Interstitial task result

result = api.get_task_result(task_id)
print(result)

Example response

{
  "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"
  }
}