Captcha token API

Captcha tokens
in one API call.

Cloudflare Turnstile, reCAPTCHA v3 and reCAPTCHA v2 behind one key. Send the page URL and its site key (for v3, also its action and script URL), and the reply carries the token or an error code.

3 captcha types · 1 request shape · errors you can act on

Follow @MINTBotUpdates for the launch.

POST /recaptcha/getToken
{ "clientKey": "<your API key>",
  "task": { "type": "ReCaptchaV2TaskProxyLess",
            "websiteURL": "https://example.com",
            "websiteKey": "6Lxxx..." } }

200 OK
{ "errorId": 0, "status": "ready", "expires_in_s": 119,
  "solution": { "gRecaptchaResponse": "03AFcWeA5..." } }
Example replies
Cloudflare TurnstileTurnstileTaskProxyLess
"status": "ready""token": "0.RD7P…"
reCAPTCHA v3ReCaptchaV3HSTaskProxyLess
"status": "ready""gRecaptchaResponse": "03AGdB…"
reCAPTCHA v2ReCaptchaV2TaskProxyLess
"status": "ready""gRecaptchaResponse": "03AFcW…"
Live status
  • Cloudflare TurnstileChecking24-hour uptime
  • reCAPTCHA v3Checking24-hour uptime
  • reCAPTCHA v2Checking24-hour uptime

Tokens served

Each solver is checked every minute, the same way your calls reach it. Uptime and incidents: status page · status.json

How it works

Three steps, no polling loop

From an API key to a token you can submit.

  1. Get a key. Keys come from our Telegram bot @mintprocheckerbot. Access is opening soon: follow @MINTBotUpdates for the launch.

    Send the key as clientKey in every request, next to task. Keep it on your server.

  2. Send one request. POST {clientKey, task} to /turnstile/getToken or /recaptcha/getToken. The call stays open until the token is ready, or answers with an errorCode: give your HTTP client a longer timeout than the task's timeout_s (each docs page gives its default). Pick task.type from the table below.

    Prefer polling? Use /createTask, then /getTaskResult. Results stay readable for 10 minutes.

  3. Use the token. It is in solution. Put it in the form field the page expects and submit it right away: each token works once.

    For Turnstile, send the User-Agent from solution.userAgent with it.

What the page showsSolverPOST totask.typeAlso sendToken in
A Cloudflare Turnstile widget (sitekey 0x4AAA…)Turnstile/turnstile/getTokenTurnstileTaskProxyLess—solution.token
No checkbox. The page loads api.js?render=6L… or render=explicit (or enterprise.js), often with a small reCAPTCHA badgereCAPTCHA v3/recaptcha/getTokenReCaptchaV3HSTaskProxyLesspageAction + apiJssolution.gRecaptchaResponse
An “I'm not a robot” checkbox (data-sitekey="6L…")reCAPTCHA v2/recaptcha/getTokenReCaptchaV2TaskProxyLess—solution.gRecaptchaResponse

For reCAPTCHA v3, apiJs is the page's full api.js (or enterprise.js) URL, copied from DevTools → Network; websiteKey is usually the 6L… key in its render= (with render=explicit, search the page source for it). Task errors also answer HTTP 200, with an errorCode; an HTTP 502 or 504 means retry in a few seconds. The error reference says whether to retry.

Tips for best results

reCAPTCHA v3: send the exact pageAction and apiJs the page uses; for strict sites, add your own residential proxy. reCAPTCHA tokens expire 120 s after they are issued, Turnstile tokens after 300 s: submit them right away.

Solvers

Supported solvers

Each solver has its own docs page; reCAPTCHA v3 and v2 share /recaptcha. All three use the same API key, the same request shape and the same reply shape.

Cloudflare Turnstile

managed & non-interactive challenges

Returns a valid Turnstile token for the page you send, in solution.token, plus the User-Agent to send with it. Add your own proxy with TurnstileTask.

  • Managed and non-interactive
  • User-Agent in the reply
  • Your own proxy
POST /turnstile/getToken
{ "clientKey": "<your API key>",
  "task": { "type": "TurnstileTaskProxyLess",
            "websiteURL": "https://example.com",
            "websiteKey": "0x4AAA..." } }

reCAPTCHA v3

score-based, action-bound tokens

Send the action name the site uses (pageAction) and the page's reCAPTCHA script URL (apiJs). The token comes back in solution.gRecaptchaResponse. reCAPTCHA Enterprise and your own proxy are supported.

  • Action-matched tokens
  • Enterprise supported
  • High-score or fast mode
POST /recaptcha/getToken
{ "clientKey": "<your API key>",
  "task": { "type": "ReCaptchaV3HSTaskProxyLess",
            "websiteURL": "https://example.com",
            "websiteKey": "6Lxxx...",
            "pageAction": "login",
            "apiJs": "https://www.google.com/recaptcha/api.js?render=6Lxxx..." } }

reCAPTCHA v2

"I'm not a robot" + image challenges

Returns a valid token for “I'm not a robot” checkboxes, including ones that show image challenges. Most calls answer in 15–25 s; each call waits up to 120 s by default. Send timeout_s to change it. The token comes back in solution.gRecaptchaResponse with expires_in_s: Google accepts it once, within 120 s.

  • Image challenges included
  • Time limit you set
  • expires_in_s with every token
POST /recaptcha/getToken
{ "clientKey": "<your API key>",
  "task": { "type": "ReCaptchaV2TaskProxyLess",
            "websiteURL": "https://example.com",
            "websiteKey": "6Lxxx..." } }

Why mintbin Solver

Simple to integrate, with public uptime

What you get with one API key.

  • One key

    Turnstile, reCAPTCHA v3 and v2 share one key, one request shape and one reply shape.

  • One call

    getToken waits, then returns the token or an error code. Polling with createTask is there if you want it.

  • Action-matched v3

    Send pageAction and apiJs, get a token for that exact action. Enterprise supported.

  • Your proxy

    Add an http, https or socks5 proxy (socks5 without a login) and the call runs through your proxy's IP. Some keys may not send a proxy.

  • Clear errors

    Every error reply has a stable errorCode and says what to do: retry, fix the request, or don't retry. A wrong reCAPTCHA site key or domain gets its own code; for Turnstile, errorDescription names the problem.

  • Open status

    Every solver is checked every minute. Uptime and incidents are public, also as JSON.

Integration

Copy, paste, call

Every solver card above has copy-ready examples. The docs have more.

  • cURL
  • PHP
  • Python
  • Node.js
  • plain HTTP
  • Familiar format. createTask / getTaskResult, errorId / errorCode and the token in solution.
  • Machine-readable docs. Add ?format=json: reCAPTCHA, Turnstile.
  • Runs on your server. Browsers block calls to this API from web pages, and a key in a page is visible to everyone.

Start with one request.

Keys come from our Telegram bot. Access is opening soon: follow @MINTBotUpdates to hear first.

May we load Google reCAPTCHA? It sets a cookie and sends Google details of your device and this visit, which helps us test our service. The site works the same either way, and you can change this anytime under Privacy choices at the bottom of each page. Privacy