タスクタイプ
reCAPTCHA v2
RecaptchaV2Task自前プロキシ
reCAPTCHA v2は「私はロボットではありません」チェックボックスと、その非表示版です。APIはgRecaptchaResponseトークンを返すので、ページのフォームと一緒に送信してください。
自前プロキシ:指定したプロキシ経由で解決するため、トークンがお客様のIPと一致します。プロキシの認証情報は解決後に削除されます。
リアルタイムメトリクス(24時間)
このタイプのリアルタイムメトリクスは、ローンチ後にステータスページに表示されます。
タスクパラメータ
| パラメータ | 型 | 必須 | タスクパラメータ |
|---|---|---|---|
type | string | 必須 | RecaptchaV2Task |
websiteURL | string | 必須 | CAPTCHAが表示されるページの完全なURL。 |
websiteKey | string | 必須 | サイトキー(data-sitekey、またはanchorリクエストのkパラメータ)。 |
isInvisible | boolean | 任意 | 非表示のreCAPTCHA v2(チェックボックスなし)の場合はtrue。 |
recaptchaDataSValue | string | 任意 | ページがdata-sを使用している場合のその値(一部のGoogleサービス)。 |
userAgent | string | 任意 | 解決に使うUser-Agent。トークンを送信する際も同じものを使ってください。 |
cookies | string | 任意 | 対象サイトのCookie(key1=value1; key2=value2形式)。 |
proxyType | string | 必須 | http、socks4、socks5のいずれか。 |
proxyAddress | string | 必須 | プロキシのIPアドレスまたはホスト(パブリックアドレスのみ)。 |
proxyPort | integer | 必須 | プロキシのポート。 |
proxyLogin | string | 任意 | プロキシのログイン名(認証が必要な場合)。 |
proxyPassword | string | 任意 | プロキシのパスワード。タスクの解決後に削除されます。 |
サンプル
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": "RecaptchaV2Task",
"websiteURL": "https://example.com/login",
"websiteKey": "6Le-SITE-KEY",
"proxyType": "http",
"proxyAddress": "203.0.113.10",
"proxyPort": 8080,
"proxyLogin": "user",
"proxyPassword": "pass",
},
}).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
その他のタスクタイプ
- reCAPTCHA v2
RecaptchaV2TaskProxyless$0.60 - reCAPTCHA v2 Enterprise
RecaptchaV2EnterpriseTaskProxyless$1.50 - reCAPTCHA v2 Enterprise
RecaptchaV2EnterpriseTask$1.50 - reCAPTCHA v3
RecaptchaV3TaskProxyless$0.90 - reCAPTCHA v3 Enterprise
RecaptchaV3EnterpriseTaskProxyless$2.00 - reCAPTCHA v3 Enterprise
RecaptchaV3EnterpriseTask$2.00