Captcha Solver API in Authorized Test Workflow

Updated 14 November 2026 · Standard formula, shown below

This guide explains how to integrate a captcha solver API into an authorized test workflow, such as automated QA testing of your own application or testing a service you have explicit permission to test. You’ll learn how to set up the API call, handle the token, and use it to bypass captchas during automated tests. Before starting, ensure you have an API key from a reputable captcha solving service and that your testing activity is authorized.

What You’ll Need

A captcha solver API key (e.g., from 2Captcha, Anti-Captcha, or Death by Captcha)
An HTTP client (like curl, Postman, or a programming language’s HTTP library)
The captcha type you’re testing (e.g., reCAPTCHA v2, hCaptcha, image captcha)
The target website’s URL and the relevant site key (if using reCAPTCHA/hCaptcha)
A test environment where you have permission to run automated tests

Step-by-Step

Identify the captcha type and its parameters. Inspect the page to determine if it uses reCAPTCHA v2, v3, hCaptcha, or a custom image captcha. For reCAPTCHA/hCaptcha, find the site key (data-sitekey attribute). For image captchas, note the image format and dimensions.
Choose a captcha solver API. Select a service that supports your captcha type. Most offer a simple HTTP API: you submit a task, poll for the result, and receive a token or answer.
Submit the captcha task. Send a POST request to the solver’s “create task” endpoint. Include your API key, the type of captcha, the site key, and the page URL. For image captchas, include the base64-encoded image. Example (reCAPTCHA v2):
```
POST https://api.captchasolver.com/create_task
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV2TaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "6Lc..."
  }
}
```
The response will contain a task ID (e.g., task_12345).
Poll for the result. Wait a few seconds (typically 5-20) and send a GET request to the solver’s “get task result” endpoint with your API key and the task ID. Keep polling until the status is “ready”. Example:
```
GET https://api.captchasolver.com/get_task_result?clientKey=YOUR_API_KEY&taskId=task_12345
{
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AFcWeA..."
  }
}
```
For image captchas, the solution will be the text answer.
Inject the token into your test. For reCAPTCHA/hCaptcha, set the token in the appropriate hidden field or call the callback function. In Selenium, you can execute JavaScript to set the g-recaptcha-response textarea and invoke the success callback. For image captchas, fill the answer into the input field.
Submit the form or continue the test. After injecting the token, proceed with the normal form submission or the next step in your test flow. The captcha should be accepted as if solved manually.
Handle errors and retries. If the captcha is rejected (e.g., token expired or incorrect), re-submit a new task. Implement a retry loop with a maximum number of attempts (e.g., 3) to avoid infinite loops.

Common Mistakes

Using the wrong site key or URL. The token is tied to the domain and site key. If the test environment uses a different domain (e.g., localhost), the token may not validate.
Not waiting long enough. Captcha solving can take time. Polling too frequently or giving up too early leads to false failures.
Ignoring the captcha type. Using a reCAPTCHA v2 solver for a v3 challenge will fail. Ensure the task type matches.
Hardcoding the token. Tokens expire quickly (usually 2 minutes). Always fetch a fresh token for each test run.
Forgetting to set the callback. Some implementations require you to call the captcha’s callback function after setting the response. Omitting this can cause the form to think the captcha is incomplete.

Tips

Use a proxy if needed. Some captcha solvers offer proxy support to avoid IP-based rate limiting. Use this if your tests are frequent.
Mock the captcha in unit tests. For most test cases, mock the captcha response rather than calling a real solver. Use the solver API only for integration tests where the captcha is essential.
Log the task ID and result. This helps debug issues when a captcha fails.
Set a timeout. Implement a timeout (e.g., 60 seconds) for the entire solving process to prevent tests from hanging.
Respect the solver’s rate limits. Avoid sending too many concurrent requests; check your provider’s documentation.

Troubleshooting

Token rejected by the site. Verify the site key and URL are correct. Ensure the token hasn’t expired (re-fetch). Also check that the captcha is actually visible on the page; if it’s hidden, the token may not be validated.
No response from the solver API. Check your API key and network connectivity. Ensure you’re using the correct endpoint (some providers have separate endpoints for v2 and v3).
Task status stuck at “processing”. Wait longer, but if it exceeds 2 minutes, cancel and retry. Some captchas are unsolvable by the service; try a different provider.
Image captcha answer is wrong. Ensure the image is clear and not distorted. Some solvers accept a base64 string; verify you’re sending the correct image data.
Captcha appears repeatedly after solving. The site may be detecting automated behavior (e.g., headless browser). Use a real browser profile or adjust your test to mimic human behavior.

Frequently Asked Questions

Is using a captcha solver API legal?

It depends on the context. Using it to test your own application or with explicit permission is generally acceptable. Using it to bypass captchas on sites without authorization violates their terms and may be illegal.

How long does it take to solve a captcha?

Typically 5-30 seconds, depending on the complexity and the solver’s workload. Image captchas are usually faster than reCAPTCHA.

Can I use a free captcha solver?

Some providers offer limited free trials, but reliable solving usually requires a paid API. Free alternatives may be slower or less accurate.

What is the difference between reCAPTCHA v2 and v3?

v2 requires user interaction (checkbox or image selection), while v3 runs in the background and assigns a score. For v3, you don’t need a token; you need to handle the score in your test.

How do I handle hCaptcha?

Most major solvers support hCaptcha. The process is similar to reCAPTCHA, but the task type is “HCaptchaTaskProxyless” and the solution is an hCaptchaResponse token.

What if the captcha is not visible on the page?

Some captchas are loaded dynamically. Ensure the page is fully loaded and the captcha iframe is present before submitting the task. You may need to wait for the element to appear.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.