← nocaptchaai.comDocs
    DocsChangelog

    Get Started

    Start Here
    QuickstartAuthenticationError Codes
    Browser Extension

    Captcha Types

    Token Tasks
    Cloudflare Turnstile Task
    Image Tasks
    ReCaptcha v2GeeTest V4ImageToTextBLS CaptchaBinanceAWS WAFTikTokDB-betMTCaptchaTencentProSOPO

    API Reference

    Overview
    Solver
    Create async captcha solving taskPoll task result (GET)Poll task resultSolve captchaGet response statusCollect endpoint (reserved)Report accuracy feedbackGet accuracy report
    Balance
    Check balance & plan infoLegacy balance formatList all error codes
    System
    Health check

    SDKs

    OverviewPythonJavaScript / Node.jsGo

    Agents

    OverviewModel Context Protocol (MCP)Claude CodeOpenAI CodexCursorClineOpenClaw

    Guides

    Browser ExtensionError HandlingChoosing a Task Type
    ← nocaptchaai.com
    Get API key
    Sign inGet API key

    GeeTest V4

    Solve GeeTest v4 image challenges with the NoCaptchaAI API.

    Loading…

    PreviousReCaptcha v2NextImageToText
    [ ] Docs[ ] Extension[ ] Pricing[ ] Changelog[ ] Partners[ ] Terms[ ] Privacy[ ] Cookies[ ] Refunds[ ] Contact

    Spicrawl

    Free web scraping API for AI agents.

    spicrawl.com

    Spicrawl

    © 2026 NoCaptchaAI

    Create a task

    POST https://api.nocaptchaai.com/createTask

    The task type is always GeetestClassification. The question field determines the sub-type.

    Supported challenge types

    All seven GeeTest v4 challenge types are supported:

    • Slide CAPTCHA-float
    • Slide CAPTCHA-popup
    • Slide CAPTCHA-bind
    • Image CAPTCHA
    • Nine-popup
    • Icon CAPTCHA
    • SVG icon CAPTCHA

    Slide captcha

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "GeetestClassification",
          "websiteURL": "https://example.com",
          "images": ["base64-background-image"],
          "slice": ["base64-slider-piece"],
          "question": "slide"
        }
      }'
    

    Grid (nine-piece) captcha

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "GeetestClassification",
          "websiteURL": "https://gt4.geetest.com/demov4/nine-popup-en.html",
          "images": [
            "base64string-1",
            "base64string-2",
            "base64string-3",
            "base64string-4",
            "base64string-5",
            "base64string-6",
            "base64string-7",
            "base64string-8",
            "base64string-9"
          ],
          "slice": [
            "base64string-10"
          ],
          "question": "grid:Select 3 images with"
        }
      }'
    

    Click captcha

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "GeetestClassification",
          "websiteURL": "https://example.com",
          "images": ["base64-background-image"],
          "slice": ["base64-example-0", "base64-example-1"],
          "question": "click:Select the same characters"
        }
      }'
    

    Match (icon-crush) captcha

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "GeetestClassification",
          "websiteURL": "https://example.com",
          "numbers": [3, 1, 2]
        }
      }'
    

    GoBang captcha

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "GeetestClassification",
          "websiteURL": "https://example.com",
          "numbers": [1, 2, 3]
        }
      }'
    

    SVG icon captcha

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "GeetestClassification",
          "websiteURL": "https://gt4.geetest.com/demov4/icon-popup-en.html",
          "images": ["main-svg-base64"],
          "slice": ["example-image-base64"],
          "question": "svgicon:Select 1 images with"
        }
      }'
    

    Get the result

    json
    // Slide — drag target:
    { "errorId": 0, "solution": { "slide": [120, 45] } }
    
    // Grid / Click — cell indexes or click points:
    { "errorId": 0, "solution": { "objects": [0, 4, 8] } }
    
    // Match / GoBang — swap coordinates:
    { "errorId": 0, "solution": { "valid_swaps": [[0, 0], [1, 1]] } }
    
    // SVG icon — object index plus geometry/scoring metadata:
    {
      "errorId": 0,
      "taskId": "",
      "status": "ready",
      "solution": {
        "objects": [0],
        "cell": 0,
        "col": 0,
        "row": 0,
        "cols": 2,
        "rows": 2,
        "x": 0.242,
        "y": 0.24,
        "viewbox_x": 72.5,
        "viewbox_y": 62.5,
        "frame": 2,
        "loop_ms": 5864,
        "visible_from_ms": 2446,
        "visible_to_ms": 4193,
        "score": 0.592
      }
    }
    
    • slide → [x, y] drag target coordinates.
    • objects → indexes to click (grid) or {x, y} point groups (click).
    • valid_swaps → two [row, col] coordinates for matching/swapping.
    • SVG icon responses also include cell, col, row, cols, rows, normalized x/y, viewbox_x/viewbox_y, animation frame/timing fields, and the model score.

    Code example

    python
    import requests
    API_KEY = "YOUR_API_KEY"; BASE = "https://api.nocaptchaai.com"
    res = requests.post(f"{BASE}/createTask", json={
        "clientKey": API_KEY,
        "task": {
            "type": "GeetestClassification",
            "websiteURL": "https://example.com",
            "images": ["base64-background-image"],
            "slice": ["base64-slider-piece"],
            "question": "slide"
        }
    }).json()
    print(res)
    

    Next steps

    API PlaygroundTry createTask live against production.QuickstartGet your API key and make a first call.More image tasksreCAPTCHA, GeeTest, OCR, BLS, AWS WAF and more.