Aws Waf Solver API

The Solverify AWS WAF CAPTCHA Solver API creates a browser-based task for pages protected by AWS WAF CAPTCHA and returns the aws-waf-token cookie in solution.cookies.

Request Parameters

Field	Required	Description
`clientKey`	Yes	Your API key.
`websiteURL`	Yes	Full URL of the target page protected by AWS WAF. Max 2048 characters.
`WafScriptUrl`	Yes	Full URL of the AWS WAF challenge script. This is the `src` attribute of the `<script id="awsThreatDetection">` tag injected by the WAF interstitial. Typically looks like `https://<id>.edge.sdk.awswaf.com/<id>/<id>/challenge.compact.js` (or `challenge.js`). Max 4096 characters.
`userAgent`	No	User-agent string to use for the request. Max 512 characters. Desktop Chrome or Chromium only.
`proxyType`	No	Proxy type. Only `http` is accepted.
`proxyAddress`	No	Proxy IP address or hostname.
`proxyPort`	No	Proxy port. Numeric string, 1 to 5 digits.
`proxyLogin`	No	Proxy username.
`proxyPassword`	No	Proxy password.

Create Task Example

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "awswaf",
    "websiteURL": "https://www.example.com/",
    "WafScriptUrl": "https://c6572918bc10.edge.sdk.awswaf.com/c6572918bc10/a3b0bb466576/challenge.compact.js",
    "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": "9ca6746d-a4b3-4b59-8e6f-617d0953e07d:DgoAeTZXYcQbAAAA:WbbRM2s4jeEh9BVUTuw2UG5TDZx7S4+...",
    "cookies": {
      "aws-waf-token": "9ca6746d-a4b3-4b59-8e6f-617d0953e07d:DgoAeTZXYcQbAAAA:WbbRM2s4jeEh9BVUTuw2UG5TDZx7S4+..."
    },
    "useragent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36"
  },
  "errorCode": null,
  "errorDescription": null
}

Timeout

AWS WAF tasks can run for up to about 100 seconds before timing out internally.

Next Steps

After creating an AWS WAF task, poll the Get Task Result API with the returned taskId. For validation and capacity errors, see Solverify API Error Codes.

API Endpoints

General