Skip to Content
AnySolver logo
AnySolver
Token

ReCaptchaV3Token

Solve a Google reCAPTCHA V3 score-based check through your own proxy and receive the token. Shows the request schema, an example and provider prices.

ReCaptchaV3Token solves a Google reCAPTCHA V3 score-based check through your proxy and returns the token. V3 runs in the background with no checkbox and no image challenge. Google scores each request from 0.0 (very likely a bot) to 1.0 (very likely a good interaction), and the site decides what to do with the score. Per Google's V3 guide, the default threshold is 0.5.

The reCAPTCHA badge shown on pages that use V3

If the target does not compare the provider's IP with your request's IP, use ReCaptchaV3TokenProxyLess. For pages that load enterprise.js, use ReCaptchaV3EnterpriseToken.

Use your proxy

task.proxy is required on this task type, and the provider solves from that address. The proxy must keep one IP for the whole solve: see Keep the same IP for the whole solve. Submit the token from the same address.

minScore

minScore is the lowest score you want the token to carry, from 0.1 to 0.9. Providers accept different values. 2Captcha and Anti-Captcha only take 0.3, 0.7 and 0.9, so AnySolver rounds your value up to the nearest one for them. Use the threshold the target enforces.

Find the action

pageAction must match the action the page sends to Google. A mismatch makes the site reject the token.

  1. Search the page JavaScript (Ctrl + Shift + F in the DevTools Sources tab) for grecaptcha.execute.
  2. Read the action from grecaptcha.execute('SITE_KEY', { action: 'THIS_VALUE' }), or from the data-action attribute of a button.

On the 2Captcha reCAPTCHA V3 demo the call uses the action demo_action. To list the actions in the inline scripts of a page, run this in the DevTools console:

(() => {
    const pattern =
        /grecaptcha\.(?:enterprise\.)?execute\s*\(\s*['"][^'"]+['"]\s*,\s*\{\s*action\s*:\s*['"]([^'"]+)['"]/g;
    const actions = [...document.querySelectorAll('script:not([src])')].flatMap((s) =>
        [...s.textContent.matchAll(pattern)].map((m) => m[1]),
    );
    console.log(actions.length ? actions : 'No action in inline scripts. Check the external JS files.');
})();

Find the sitekey

V3 has no visible widget, so the sitekey is in the script URL and the execute call, and it goes into websiteKey:

  • the render parameter of the script URL: recaptcha/api.js?render=SITE_KEY
  • the first argument of grecaptcha.execute('SITE_KEY', ...)
  • the k parameter of the api2/anchor request in the Network tab

To read it from the script URL, run this in the DevTools console:

(() => {
    const script = [...document.querySelectorAll('script[src*="recaptcha"]')]
        .map((s) => new URL(s.src, location.href).searchParams.get('render'))
        .find((render) => render && render !== 'explicit');
    console.log('sitekey:', script ?? 'Not found');
})();

Optional parameters

  • apiDomain: set to recaptcha.net when the page loads its script from there instead of google.com.
  • isSession: also returns the recaptcha-ca-t session cookie in solution.cookies. Only providers that expose session cookies honor it.

Submit the token

Per Google's V3 guide, tokens expire after two minutes, so submit the token right after you receive it. Send it the way the page does: in a g-recaptcha-response form field, or as a parameter of the request that the page's grecaptcha.execute() call feeds. To find that parameter, trigger the action once in a browser with the DevTools Network tab open. If the site rejects the token, check that the proxy kept one IP for the whole solve, then that pageAction and websiteKey match the page.

Check Provider stats for live success rates and solve times before you pick a provider.

Supported Providers

ProviderPrice per 1,000Routing
CapSolver
$1.00
Multibot
$0.48
RiskBypass
$2.00
Nslsolver
$1.50
EZCaptcha
$1.00–$1.80
SolveCaptcha
$0.80
Castlebreaker
$1.00
Iso
$1.00
SCTG
$0.08–$0.24
VoidCaptcha
$0.80–$2.00

Request Schema

FieldTypeRequiredDescription
clientKey*
stringYes

Your API key. Create one in a workspace of the AnySolver dashboard.

Example: your-api-key-from-dashboard

task*
objectYes

The task body. Required fields depend on the task type. See Tasks for per-task schemas.

View task properties
settings
objectNo

Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes.

View settings reference

Task Object Properties

The task field accepts an object with the following properties:

FieldTypeRequiredDescription
type*
Yes
websiteURL*
URLYes

Full URL of the page where the CAPTCHA is displayed.

Example: https://2captcha.com/demo/recaptcha-v3

websiteKey*
stringYes

The sitekey found in the CAPTCHA HTML element on the target page.

Example: 6LfB5_IbAAAAAMCtsjEHEHKqcB9iQocwwxTiihJu

pageTitle*
stringYes

Title of the target page (document.title). Send it on every task, although only a few providers read it, as an additional hint.

Example: Google reCAPTCHA v3 demo: Sample Form with Google reCAPTCHA v3

proxy*
string | objectYes

Proxy the provider solves through, as a string or an object. See Proxy configuration.

View proxy configuration

Example: http://user:pass@1.2.3.4:8080

pageAction
stringNo

Action the page passes to grecaptcha.execute(siteKey, { action: "..." }) or sets in data-action, such as verify, submit or login. It must match the page exactly, or the site rejects the token.

Example: demo_action

minScore
numberNo

Minimum reCAPTCHA V3 score to request, from 0.1 to 0.9. Providers accept different values: 2Captcha and Anti-Captcha only take 0.3, 0.7 and 0.9, and AnySolver rounds up to the nearest one for them.

Example: 0.9

apiDomain
stringNo

Domain the page loads reCAPTCHA from: google.com (the default) or recaptcha.net. Set recaptcha.net when the api.js or enterprise.js script URL uses it.

Example: www.recaptcha.net

isSession
booleanNo

Session mode: also return the recaptcha-ca-t session cookie in the solution cookies, for sites that read it with the token. Only providers that expose session cookies honor it; the rest ignore it.

Example: false

{
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "ReCaptchaV3Token",
        "websiteURL": "https://2captcha.com/demo/recaptcha-v3",
        "websiteKey": "6LfB5_IbAAAAAMCtsjEHEHKqcB9iQocwwxTiihJu",
        "pageTitle": "Google reCAPTCHA v3 demo: Sample Form with Google reCAPTCHA v3",
        "proxy": "http://user:pass@1.2.3.4:8080"
    }
}

Optional fields are not guaranteed across providers

Required fields are guaranteed across every provider that supports this task. Optional fields may be honored by some providers and silently ignored by others. AnySolver does not document per-provider parameter support, so before relying on an optional field, check that provider's own docs for the task you are using.

Response Schema

FieldTypeRequiredDescription
status*
Yes

Task status: "processing", "ready", or "failed".

Example: ready

errorId*
Yes

0 on success; 1 or 2 on an error. Branch on errorCode: Error IDs explains the two error groups.

Example: 0

taskId
stringNo

Unique identifier returned when the task was created.

Example: 01KFNDF328KAN2AJ3BNHCQYE88

errorCode
No

Machine-readable error code.

Example: CAPTCHA_UNSOLVABLE

errorDescription
stringNo

Human-readable error message with resolution hints.

Example: The captcha could not be solved.

cost
numberNo

Actual cost charged for this task in USD.

Example: 0.002

taskType
No

The type of CAPTCHA task to solve.

Example: ReCaptchaV2TokenProxyLess

provider
No

Provider that handled this task. While processing, the provider currently solving it.

Example: Multibot

solution
objectNo

Solution Object Properties

The solution field contains an object with the following properties:

FieldTypeRequiredDescription
token*
stringYes

The solved CAPTCHA token to submit with your form.

Example: 03ADUVZwB7eLoqnBxvi5H...kA4Si3qH0rR0g

raw*
Record<string, unknown>Yes

Raw provider response data for advanced use cases.

userAgent
stringNo

User-Agent string used during solving.

cookies
Record<string, unknown>No

Session cookies obtained during solving.