Which task type should I use?

Use AwsWafClassification if you already run your own browser (Selenium, Puppeteer, Playwright) and just hit a wall on the image grid — it's ~10× cheaper and 5-10× faster. Use AntiAwsWafTask* if you want the whole flow handled and a cookie returned.

How do I use the cookie returned by AntiAwsWafTask?

Set the aws-waf-token cookie on your HTTP client before making requests to the protected page.

What images do I send to AwsWafClassification?

The 9 grid tiles as base64-encoded PNG/JPEG strings, in the order they appear top-left to bottom-right. We return 0-based indices of tiles that matched your target.

Does AwsWafClassification support the toy-car-city challenge?

Not yet. Only aws:grid:* questions are supported. Toy-car-city and similar puzzle types should use AntiAwsWafTask which handles them in the browser flow.

AWS WAF Captcha Solver

What is AWS WAF Captcha?

AWS WAF Captcha is Amazon's bot detection on sites using AWS Web Application Firewall. The challenge has two parts: a proof-of-work token, and (when escalated) an image grid where you select tiles matching a target — chairs, bags, spoons, etc. We ship two task types because customer integrations differ. If you want the full aws-waf-token cookie hands-off, use AntiAwsWafTask*. If you're already running your own browser/Selenium and just need the right tile indices, use AwsWafClassification — sub-3 second image-only API, no browser, no proxy bandwidth charged.

How It Works

Send Task

POST your AntiAwsWafTask with the target URL and sitekey to our API. We'll queue it instantly.

We Solve

AntiAwsWafTask*: Capzy's proprietary solver handles AWS WAF proof-of-work and image-grid challenges end-to-end. Routed through residential when needed. AwsWafClassification: classification-only mode — submit the 9 base64 tiles + question code (e.g. aws:grid:chair) and we return the matching indices. You keep your own browser session.

Get Token

Poll getTaskResult — when status is 'ready', the solution contains the token to inject into the target page.

Quick Integration

solve.py

import requests, time

API = "https://api.capzy.ai"
KEY = "capzy_your_key_here"

# Step 1: Create task
task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
        "type": "AntiAwsWafTask",
        "proxyPort": "8080",
        "proxyType": "http",
        "proxyLogin": "user",
        "websiteURL": "https://example.com/protected-page",
        "proxyAddress": "123.45.67.89",
        "proxyPassword": "pass"
    }
}).json()

task_id = task["taskId"]
print(f"Task created: {task_id}")

# Step 2: Poll for result
while True:
    result = requests.post(f"{API}/getTaskResult", json={
        "clientKey": KEY,
        "taskId": task_id
    }).json()

    if result["status"] == "ready":
        print("Solved!", result["solution"])
        break
    elif result["status"] == "failed":
        print("Failed:", result.get("errorDescription"))
        break

    time.sleep(1)

task parameters.

Proxy fields below are required for this captcha — userAgent must match the one you’ll use when submitting the resulting token.

fieldtyperequireddescription

typetypestringreqyesAntiAwsWafTaskProxyLess or AntiAwsWafTask (token flow), or AwsWafClassification (image-only)

websiteURLtypestringreqnoToken flow only — the page URL showing the AWS WAF challenge

imagestypestring[]reqnoAwsWafClassification only — array of base64-encoded grid tile images (typically 9)

questiontypestringreqnoAwsWafClassification only — the target label, e.g. "aws:grid:chair", "aws:grid:bag", "aws:grid:spoon"

proxyTypetypestringreqyesProxy protocol: http, https, socks4, or socks5

proxyAddresstypestringreqyesProxy IP address or hostname

proxyPorttypenumberreqyesProxy port number

proxyLogintypestringreqnoProxy username (if auth required)

proxyPasswordtypestringreqnoProxy password (if auth required)

userAgenttypestringreqyesUser-Agent string to use. Must match the UA you use when submitting the token

solution response.

fieldtypedescription

cookietypestringToken flow — the aws-waf-token cookie value

objectstypenumber[]Classification — 0-based indices of tiles that matched the target label

scorestypenumber[]Classification — per-tile confidence (parallel to your input order)

Features

Two task types: full token flow + image-only classification

Token flow: sub-second lightweight path with browser fallback

Image-only: sub-3s, no browser, no proxy bandwidth — $0.0008/solve

Capzy proprietary classifier — covers all standard AWS WAF grid labels

Browser fallback routed through residential pool when AWS escalates

Required Task Type

AntiAwsWafTask

Frequently Asked Questions

start solving aws waf captcha.

$0.10 in free credits — no card. ~250 free solves to test before you spend.

get free api key read docs

AWS WAF Captcha Solver, solved in 15.0s.