Quickstart
Solve your first captcha with the NoCaptchaAI API in minutes.
Loading…
Solve your first captcha with the NoCaptchaAI API in minutes.
Loading…
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.
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.
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:
export NOCAPTCHAAI_KEY="YOUR_API_KEY"
Send a POST request to /createTask describing the challenge you want solved.
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:
{
"errorId": 0,
"status": "idle",
"taskId": "8f0e5b2a-1c3d-4e6f-9a0b-1c2d3e4f5a6b"
}
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.
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:
{
"errorId": 0,
"status": "ready",
"solution": {
"token": "0.aBcDeFgH...turnstile-response-token"
}
}
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.
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.