← 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

    Quickstart

    Solve your first captcha with the NoCaptchaAI API in minutes.

    Loading…

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

    Spicrawl

    Free web scraping API for AI agents.

    spicrawl.com

    Spicrawl

    © 2026 NoCaptchaAI

    Solve your first captcha with the NoCaptchaAI API in three short steps: create a task, poll for the result, and use the returned token.

    Base URL: https://api.nocaptchaai.com — Grab your free API key from the NoCaptchaAI dashboard.

    Solve a captcha with the API

    The API is asynchronous: you submit a task, then poll for its result. The example below solves a Cloudflare Turnstile challenge, but the same flow works for every supported captcha type.

    Get your API key

    Sign in to the NoCaptchaAI dashboard and copy your clientKey from the API section. Keep it secret — treat it like a password.

    Export it so the snippets below can pick it up:

    bash
    export NOCAPTCHAAI_KEY="YOUR_API_KEY"
    

    Create a task

    Send a POST request to /createTask describing the challenge you want solved.

    bash
    curl -s -X POST https://api.nocaptchaai.com/createTask \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "'"$NOCAPTCHAAI_KEY"'",
        "task": {
          "type": "AntiTurnstileTask",
          "websiteURL": "https://example.com",
          "websiteKey": "0x4AAAAAAA..."
        }
      }'
    

    A successful response returns a taskId you'll use to fetch the result:

    json
    {
      "errorId": 0,
      "status": "idle",
      "taskId": "8f0e5b2a-1c3d-4e6f-9a0b-1c2d3e4f5a6b"
    }
    

    Poll for the result

    Send the taskId to /getTaskResult until status is "ready". While the task is still being solved you'll get status: "processing" — wait a couple of seconds and try again.

    bash
    curl -s -X POST https://api.nocaptchaai.com/getTaskResult \
      -H "Content-Type: application/json" \
      -d '{
        "clientKey": "'"$NOCAPTCHAAI_KEY"'",
        "taskId": "8f0e5b2a-1c3d-4e6f-9a0b-1c2d3e4f5a6b"
      }'
    

    When the task is solved, the response includes the token under solution.token:

    json
    {
      "errorId": 0,
      "status": "ready",
      "solution": {
        "token": "0.aBcDeFgH...turnstile-response-token"
      }
    }
    

    Use the solution

    The returned solution.token is the captcha response you submit to the target site — exactly as a real browser would. For Turnstile and reCAPTCHA, place it in the form field the site expects (for example cf-turnstile-response or g-recaptcha-response) and send your request as usual.

    Tokens are single-use and short-lived. Submit each token immediately and request a fresh task for every new attempt.

    No-code option

    Prefer not to write code? Install the browser extension and let NoCaptchaAI solve captchas automatically as you browse — just sign in with the same API key.

    Chrome ExtensionInstall for Google Chrome and Chromium browsers.Firefox Add-onInstall for Mozilla Firefox.

    Next steps

    AuthenticationLearn how the clientKey works and how to keep it secure.SDKsUse the official libraries instead of raw HTTP.API ReferenceEvery task type, parameter, and response field.Error HandlingHandle errors and retries like a pro.