← 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

    ReCaptcha v2

    Solve reCAPTCHA v2 image challenges with the NoCaptchaAI API.

    Loading…

    PreviousCloudflare Turnstile TaskNextGeeTest V4
    [ ] 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

    bash
    curl -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "YOUR_API_KEY",
        "task": {
          "type": "ReCaptchaV2Classification",
          "questionType": "33",
          "image": [
            "base64-of-cell-0",
            "base64-of-cell-1"
          ],
          "question": "Select all images with traffic lights",
          "websiteURL": "https://example.com"
        }
      }'
    

    questionType values

    ValueGridDescription
    "33"3×39 individual cell images in image
    "44"4×416 individual cell images in image
    "split_33"3×3Single full source image in image (server splits it)

    Get the result

    json
    // For "33" / "44" — cell indexes to click:
    { "errorId": 0, "solution": { "objects": [0, 3, 7] } }
    
    // For "split_33" — either form is accepted:
    { "errorId": 0, "solution": { "objects": [0, 5, 8] } }
    { "errorId": 0, "solution": { "hasObject": [true, false, true] } }
    
    • objects → array of cell indexes to click.
    • hasObject → boolean per cell; true cells get clicked.
    • An empty objects array triggers a captcha reload.

    Audio challenge

    reCAPTCHA also offers an audio challenge. Download the MP3 from .rc-audiochallenge-tdownload-link (or the #audio-source element) and send it to the synchronous /solve endpoint as multipart form data.

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

    Fallback hosts: https://backup1.nocaptchaai.com/solve, https://backup2.nocaptchaai.com/solve

    FieldTypeDescription
    methodstringMust be rcaudio.
    audiofileMP3 audio file downloaded from the reCAPTCHA audio challenge.

    Send the API key in the apikey header, not in the body.

    bash
    curl -X POST "https://api.nocaptchaai.com/solve" \
      -H "apikey: YOUR_API_KEY" \
      -F "method=rcaudio" \
      -F "audio=@challenge.mp3;type=audio/mpeg"
    

    Audio response

    json
    {
      "solution": "1 9 4 0 3",
      "id": "req_65f2a1b9c4..."
    }
    
    • solution → transcribed numbers or words. Enter this into #audio-response on the challenge page.
    • id → unique task/transaction identifier.

    Use multipart/form-data for audio tasks. Do not JSON-encode the MP3 or send it as a base64 field.

    Browser extension message

    Extension content scripts should send the audio bytes to the background worker, which rebuilds the FormData with a Blob:

    js
    chrome.runtime.sendMessage({
      type: "networkRequest",
      payload: {
        url: "https://api.nocaptchaai.com/solve",
        method: "POST",
        headers: {
          apikey: apikey,
        },
        body: {
          audio: audioBytes, // Array.from(new Uint8Array(audioArrayBuffer))
          method: "rcaudio",
        },
        isFormData: true,
      },
    });
    

    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": "ReCaptchaV2Classification",
            "questionType": "33",
            "image": ["base64-cell-0", "base64-cell-1", "..."],
            "question": "Select all images with traffic lights",
            "websiteURL": "https://example.com"
        }
    }).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.