2Captcha API

What authentication does the 2Captcha API use?

The 2Captcha API uses an API key passed as the clientKey field in the JSON body of every request, not as a header. There is no OAuth or bearer token. Through Jentic the clientKey is stored encrypted in your Jentic One instance and injected into the request at execution time, so the agent never sees the raw key value.

Can I solve reCAPTCHA v3 with the 2Captcha API?

Yes. Submit a RecaptchaV3TaskProxyless task to /createTask with the websiteURL, websiteKey, the action name, and your minimum acceptable score (typically 0.3 or 0.7), then poll /getTaskResult until status is 'ready' to retrieve the gRecaptchaResponse token. The same five-endpoint flow handles reCAPTCHA v2, hCaptcha, Turnstile, and image captchas - only the task type changes.

How do I poll for a captcha solution through Jentic?

Use Jentic's search to find the operation ('solve a captcha' or 'get captcha result'), load the getTaskResult schema, then execute it with the taskId returned from createTask. 2Captcha's docs recommend a first poll after about 5 seconds and additional polls every 5 seconds until the response status field is 'ready', at which point the solution field contains the token or text.

What are the rate limits for the 2Captcha API?

The OpenAPI spec does not declare numeric rate limits. In practice 2Captcha throttles by account: getTaskResult should be polled no more often than every 5 seconds per task, and very high createTask submission rates may be slowed under heavy load. Concurrency limits depend on your account tier - check your dashboard for the current cap.

How do I get a refund for a bad captcha solution?

Call /reportIncorrect with the taskId of the solution that did not work on the target site. 2Captcha will refund the cost of that task and feed the signal back to the worker pool. Report only solutions that genuinely failed - abusing reportIncorrect can lead to account restrictions.

Is the 2Captcha API free?

No. 2Captcha is a prepaid service - you top up a balance and each solved captcha deducts a small amount (rates vary by task type, with image captchas cheapest and reCAPTCHA / hCaptcha more expensive). Use /getBalance to read the current balance from your code so you can gate submissions when funds run low.

Can I limit what my agent is allowed to do with the 2Captcha API?

Yes. Because you run Jentic One yourself, your own rules decide which 2Captcha operations and credentials the agent can use, and only the operations you pick can run. Since 2Captcha carries the task and its type in the request body rather than a resource id in the path, you scope by operation: allow just creating a task with /createTask and reading its result with /getTaskResult, and leave out /getBalance, /reportCorrect, and /reportIncorrect unless you add them. The client key stays with your instance and is injected at execution time, so the agent can only call the endpoints you have permitted.