createTask

Creates a task and returns taskId at once. The price is held and charged only if the task is solved.

Цей розділ показано англійською.

На цій сторінці

Request
The task object
Example
Response
Billing
Limits
Errors
Try it

Endpoint

POST https://neurocaptcha.com/createTask

Creates a task and answers at once with taskId. Get the solution with getTaskResult or receive it at callbackUrl.

Request#

ПараметрОпис

clientKey stringобов’язковий: Your API key.
task objectобов’язковий: The task: its type and parameters (below).
callbackUrl string: Public http(s) URL for a signed webhook when the task is finished. Private addresses are rejected.
softId integer: Your application id in the developer program: you get a share of the spending of clients who use your application.
languagePool string: Accepted for compatibility with Anti-Captcha; ignored.

The task object#

Which fields matter depends on the task type; unknown fields are ignored.

ПараметрОпис

type stringобов’язковий: Task type, see task types.
websiteURL stringобов’язковий: Full address of the page where the reCAPTCHA is shown: http(s), up to 2048 characters. The page, not the address of the reCAPTCHA iframe.
websiteKey stringобов’язковий: Site key: the data-sitekey attribute of the widget or the k parameter of the anchor request in DevTools → Network. Up to 256 characters, no spaces.
isInvisible boolean: true for invisible reCAPTCHA v2 (the widget has data-size="invisible" and shows only a badge). Default false.
recaptchaDataSValue string: The data-s value if the page passes one (some Google services do). Up to 4096 characters.
pageAction string: The action the page passes to grecaptcha.execute(sitekey, {action: …}), e.g. login. Up to 128 characters.
minScore number: Minimum score of the token from 0 to 1, usually 0.3, 0.7 or 0.9.
enterprisePayload object: Extra parameters of grecaptcha.enterprise.render / execute, e.g. {"s": "…"}, up to 8 KiB of JSON. If recaptchaDataSValue or pageAction is empty, the s and action keys are used instead.
isEnterprise boolean: Compatibility flag of Anti-Captcha clients: true turns a regular reCAPTCHA type into its Enterprise twin (solved and billed as Enterprise). Prefer the Enterprise task types.
apiDomain string: Domain the widget is loaded from: www.google.com (default) or www.recaptcha.net.
userAgent string: User-Agent of the browser that will submit the token, up to 512 characters. It is returned in solution.userAgent.
cookies string: Cookies of the target site for the solving browser: name=value; name2=value2, up to 8192 characters. Stored encrypted.
proxyType string: http (default), https, socks4 or socks5.
proxyAddress stringдля типів із проксі: IP address or host name of the proxy. Private and local addresses are rejected.
proxyPort integerдля типів із проксі: Proxy port, 1–65535.
proxyLogin string: Proxy login, up to 256 characters. Stored encrypted.
proxyPassword string: Proxy password, up to 256 characters. Stored encrypted.

Example#

import requests

response = requests.post("https://neurocaptcha.com/createTask", json={
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "RecaptchaV2TaskProxyless",
        "websiteURL": "https://www.google.com/recaptcha/api2/demo",
        "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    },
}, timeout=30)
print(response.json())

Response#

Success

{
  "errorId": 0,
  "taskId": 7781
}

Error

{
  "errorId": 22,
  "errorCode": "ERROR_TASK_ABSENT",
  "errorDescription": "websiteURL must be an absolute http(s) URL."
}

Billing#

The task price (after your volume discount) is held on createTask. getBalance shows the balance without held amounts.
The money is charged only when the task becomes ready. A failed or expired task releases the hold — it costs nothing.
Test keys are free.
Got a token the site rejected? reportIncorrectRecaptcha within 24 h returns the money.

Limits#

30 createTask per second per key (bursts up to 60) — above it ERROR_TOO_MUCH_REQUESTS.
200 tasks in progress per key (can be changed per key) — above it ERROR_NO_SLOT_AVAILABLE.
Request body up to 1 MiB.

Errors#

errorId	errorCode	When
1	`ERROR_KEY_DOES_NOT_EXIST`	wrong or revoked key
2	`ERROR_NO_SLOT_AVAILABLE`	too many tasks of the key in progress
10	`ERROR_ZERO_BALANCE`	the available balance is below the task price
11	`ERROR_IP_NOT_ALLOWED`	the IP is not in the key's allowlist
14	`ERROR_NO_SUCH_METHOD`	the body is not valid JSON
22	`ERROR_TASK_ABSENT`	`task` is missing or a field is invalid — see `errorDescription`
23	`ERROR_TASK_NOT_SUPPORTED`	unknown or disabled task type
55	`ERROR_ACCOUNT_SUSPENDED`	the account is suspended
90	`ERROR_INTERNAL`	temporary failure, retry
91	`ERROR_TOO_MUCH_REQUESTS`	rate limit of the key or IP
92	`ERROR_SPENDING_LIMIT`	daily or monthly cap of the key reached

Try it#

Пісочниця

Надсилає справжній запит createTask з вашого браузера, потім кожні 2 секунди викликає getTaskResult і показує відповіді в JSON як є.

API-ключ

Використовуйте тестовий ключ: це безкоштовно, а фіктивний токен TEST_ надходить за пару секунд. Ключ ніде не зберігається. Отримати ключ

Тип завдання

websiteURL

websiteKey

recaptchaDataSValue · необов’язково

isInvisible (невидима reCAPTCHA)

Додаткові параметри

userAgent

apiDomain

callbackUrl (вебхук)

Готово до надсилання

Запити надсилаються на адресу цього ж сайту; ключ і відповіді залишаються у вашому браузері.

Запит

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2TaskProxyless",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
  }
}

Відповідь

createTask

// …