ceven

Twocaptcha

Automates the solving of CAPTCHAs across your web scraping and data collection pipelines to prevent bot detection blocks.

Try Twocaptcha in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Twocaptcha integration

    • Describe the outcome and Ceven picks the right Twocaptcha calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Twocaptcha data, across all 5 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Twocaptcha access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Twocaptcha, when, and on whose behalf.
    • The agent pauses and asks when Twocaptcha is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Twocaptcha.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Twocaptcha action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Twocaptcha, and when to use it.

Create task
Use this when you need to initiate solving of any supported captcha type by submitting the required site parameters.
Get result
Pull the solved token for a specific task ID. Use this after the solving process has had time to complete.
Get balance
Check the remaining account credit to ensure the workflow has enough funds to continue solving tasks.
Create image task
Upload a base64 image of a standard CAPTCHA for a worker to solve and return the text.
Create reCAPTCHA task
Submit the site key and page URL specifically for reCAPTCHA v2 or v3 challenges.
Create hCaptcha task
Submit the site key and page URL for hCaptcha challenges to retrieve a valid bypass token.
Create GeeTest task
Send the site key and site URL for GeeTest challenges to automate the solving process.
Check task status
Query the current state of a task to see if it is processing, completed, or failed.
Cancel task
Stop a pending task to avoid wasting credits if the target page has already timed out.
Get account info
Pull detailed account settings and API limits to optimize the request rate of your agents.
Set worker parameters
Define specific requirements for how workers should solve a task for higher accuracy.
Create Turnstile task
Submit parameters for Cloudflare Turnstile challenges to maintain access to protected sites.
Create CAPTCHA Task
Tool to create a new captcha solving task. use when you need to initiate solving of any supported captcha type. call after assembling captcha parameters.

13 actions · scroll to see them all

Frequently asked questions

Ceven implements a polling loop when a 2Captcha task is created. Instead of timing out the entire workflow, the agent enters a wait state and checks the task status at optimized intervals. Once the solver returns the token, the agent immediately resumes the browser interaction and injects the token into the hidden field of the target website. This ensures that the session remains active and does not expire while waiting for the human worker or AI solver to complete the task. You can configure the maximum wait time in your workflow settings to prevent infinite loops on particularly difficult challenges.
The primary limit is your 2Captcha account balance and the specific API rate limits set by the vendor. 2Captcha typically allows a high volume of requests, but sending thousands of tasks in a single second can lead to temporary IP blocks or 429 errors. Ceven manages this by implementing a request queue that spreads out task creation based on your account tier. If the agent receives a rate limit response, it will automatically apply an exponential backoff strategy to retry the request without failing the overall workflow, ensuring your data collection remains steady.
If a task returns an error or the solver cannot find a solution, Ceven catches the failure response. Depending on your workflow logic, the agent can either retry the task with a different set of parameters, try an alternative solving method, or flag the record for manual review. Because some CAPTCHAs are dynamically generated and expire quickly, the agent tracks the time since the task was created. If a solution arrives too late to be accepted by the target website, Ceven treats it as a failure and automatically triggers a page refresh to get a fresh challenge.
Ceven can solve any CAPTCHA type supported by the 2Captcha API, which includes reCAPTCHA v2 and v3, hCaptcha, GeeTest, and standard image based challenges. However, some highly advanced security systems use behavioral analysis that goes beyond a simple token. In those cases, while 2Captcha provides the token, the target site might still block the request if the browser fingerprint looks suspicious. To mitigate this, we recommend using Ceven in conjunction with high quality residential proxies to ensure the token is submitted from an IP address that matches the expected geographic location.
Your 2Captcha API key is stored using industry standard encryption at rest and is never exposed in plain text within your workflow logs. When an agent needs to create a task, the key is injected into the request header in a secure execution environment. You can update or rotate your key at any time through the Ceven integration settings. We do not share this key with any third party, and it is only used to authenticate requests to the 2Captcha API on your behalf to ensure your credits are billed correctly.
There is an inherent delay because CAPTCHA solving requires external processing, often taking between 15 and 60 seconds. Ceven minimizes this impact by using asynchronous task creation. The agent sends the request and then performs other non dependent tasks in your workflow while waiting for the result. By optimizing the sequence of operations, the agent ensures that the solve time is the only bottleneck. For high volume operations, we suggest creating tasks in batches where possible to reduce the overhead of multiple API handshakes.
Failures usually occur due to incorrect site keys or expired page sessions. A common quirk of the 2Captcha API is that if the site key provided does not exactly match the one currently active on the target page, the solver will return an error or an invalid token. Ceven helps prevent this by dynamically extracting the site key from the HTML of the live page right before sending the request. Another limitation is that some sites use invisible CAPTCHAs that require a specific sequence of clicks to trigger, which may require fine tuning the browser automation steps before the solve task is initiated.
Ceven provides a balance tracking capability that can be integrated into your monitoring alerts. You can set up a workflow that checks your 2Captcha balance every hour and sends a notification to Slack or email if the funds drop below a certain threshold. Since 2Captcha charges per solved CAPTCHA, this prevents your data pipelines from stopping unexpectedly. You can also log the number of tasks created per workflow run to analyze which target websites are the most expensive to scrape based on the frequency of challenges.

Alternatives to Twocaptcha

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

AntiCaptcha logoAntiCaptchaDeathByCaptcha logoDeathByCaptchaCapMonster logoCapMonster

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Twocaptcha and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free