Task type
reCAPTCHA v3
RecaptchaV3TaskProxylessproxyless
reCAPTCHA v3 has no widget: the site scores every action from 0.0 to 1.0. The API returns a token for the requested pageAction; minScore sets the score you need.
Proxyless: we solve from our own infrastructure. Best when the target does not bind the token to an IP.
Live metrics, 24 h
Live metrics for this type will appear on the status page after launch.
Task parameters
| Parameter | Type | required | Task parameters |
|---|---|---|---|
type | string | required | RecaptchaV3TaskProxyless |
websiteURL | string | required | Full URL of the page with the captcha. |
websiteKey | string | required | Site key (data-sitekey or the k parameter of the anchor request). |
minScore | number | optional | Score you need from 0.1 to 0.9. Higher scores take longer. |
pageAction | string | optional | Action name passed to grecaptcha.execute on the page. |
userAgent | string | optional | User-Agent to solve with; use the same one when submitting the token. |
cookies | string | optional | Cookies for the target site in the key1=value1; key2=value2 format. |
Example
import time
import requests
API = "https://"
KEY = "YOUR_API_KEY"
# 1. create a task: the price is held, not charged
task = requests.post(f"{API}/createTask", json={
"clientKey": KEY,
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-SITE-KEY",
"minScore": 0.7,
"pageAction": "login",
},
}).json()
if task["errorId"]:
raise RuntimeError(task["errorCode"])
# 2. poll the result (or pass "callbackUrl" and get a signed webhook)
while True:
time.sleep(3)
res = requests.post(f"{API}/getTaskResult",
json={"clientKey": KEY, "taskId": task["taskId"]}).json()
if res["errorId"]:
raise RuntimeError(res["errorCode"])
if res["status"] == "ready":
print(res["solution"]["gRecaptchaResponse"])
break
Other task types
- reCAPTCHA v2
RecaptchaV2TaskProxyless$0.60 - reCAPTCHA v2
RecaptchaV2Task$0.60 - reCAPTCHA v2 Enterprise
RecaptchaV2EnterpriseTaskProxyless$1.50 - reCAPTCHA v2 Enterprise
RecaptchaV2EnterpriseTask$1.50 - reCAPTCHA v3 Enterprise
RecaptchaV3EnterpriseTaskProxyless$2.00 - reCAPTCHA v3 Enterprise
RecaptchaV3EnterpriseTask$2.00