Use this file to discover all available pages before exploring further.
Integrating 2Captcha with ZenRows gives you an extra layer of protection to handle interactive CAPTCHAs that appear on web pages. This guide shows you how to set up 2Captcha with both the ZenRows Universal Scraper API and the ZenRows Scraping Browser.
2Captcha is a CAPTCHA-solving service that employs humans to solve various types of CAPTCHA challenges. Here’s how 2Captcha works:
The scraper submits the CAPTCHA challenge as a unique key (e.g., sitekey for reCAPTCHA) via 2Captcha’s API.
A human solver receives and solves the CAPTCHA challenge manually.
The human worker returns the CAPTCHA solution as a hashed token.
The scraper supplies the solution token to the site and solves the challenge.
The service is particularly useful for solving in-page CAPTCHAs, ensuring complete CAPTCHA evasion. These include CAPTCHAs attached to form fields or those that appear when you interact with page elements.You’ll learn to integrate 2Captcha with ZenRows in the next sections of this guide. To demonstrate the solution, we’ll use the reCAPTCHA demo page as the target website.
Integrating 2Captcha With the Universal Scraper API
The Universal Scraper API automatically bypasses website protections, but you should combine it with 2Captcha for interactive or form-based CAPTCHAs. This approach requires minimal code changes and helps handle unexpected blocks.
Step 2: Integrate 2Captcha in your scraping request
After adding the 2Captcha ZenRows integration, you need to specify its usage in your Universal Scraper API request via the js_instructions parameter. ZenRows handles all communication between your script and 2Captcha.The js_instructions parameter accepts a solve_captcha option that specifies which CAPTCHA type you want to solve.ZenRows’s Universal Scraper API supports these CAPTCHA types for 2Captcha integration:
recaptcha: Google reCAPTCHA series, including invisible CAPTCHAs that don’t require user interaction.
cloudflare_turnstile: Cloudflare Turnstile CAPTCHAs are typically found on forms and interactive elements.
Here are the supported CAPTCHA types with their configuration options:
Now, let’s implement the js_instructions in your ZenRows request. In this example, the script waits for 3 seconds, solves the reCAPTCHA challenge using 2Captcha, waits 3 seconds for processing, clicks the submit button, and then waits for the success message to be present:
The CSS selectors provided in this example (._successMessage_1ndnh_1, button[type='submit']) are specific to the page used in this guide. Selectors may vary across websites. For guidance on customizing selectors, refer to the CSS Extractor documentation. If you’re having trouble, the Advanced CSS Selectors Troubleshooting Guide can help resolve common issues.
This response is equivalent to manually clicking the “Check” button on the reCAPTCHA demo page to verify the CAPTCHA was solved.
The json_response parameter is used here for debugging purposes. For production use, you can parse the response.text with a parser like BeautifulSoup since the request returns the HTML content that was previously locked behind the CAPTCHA.
Integrating 2Captcha With the ZenRows Scraping Browser
The ZenRows Scraping Browser doesn’t include direct 2Captcha integration, but you can achieve this using the 2Captcha SDK. Here’s how to set it up using Playwright with the Scraping Browser in Python.
Step 3: Connect to the Scraping Browser and obtain the CAPTCHA Token
Connect to the Scraping Browser, navigate to your target page, and extract the reCAPTCHA sitekey (a unique identifier for the CAPTCHA):
Python
# ... # scraping browser connection URL connection_url = ( "wss://browser.zenrows.com?apikey=YOUR_ZENROWS_API_KEY" ) async with async_playwright() as p: # connect to the browser over CDP (Chrome DevTools Protocol) browser = await p.chromium.connect_over_cdp(connection_url) # create a new page page = await browser.new_page() # navigate to the target URL await page.goto(url) # wait for the reCAPTCHA sitekey to load and extract it await page.wait_for_selector("#g-recaptcha") site_key = await page.evaluate( "document.querySelector('#g-recaptcha').getAttribute('data-sitekey')" ) # solve CAPTCHA captcha_response = solver.recaptcha(sitekey=site_key, url=url) # extract the reCAPTCHA token from the response captcha_token = captcha_response["code"]
This code extracts the sitekey from the reCAPTCHA element and sends it to 2Captcha for solving.
When a user solves a CAPTCHA, the solution token gets placed in a hidden input field. You need to simulate this process by injecting the token into the appropriate field:
Python
# ...async def scraper(url): async with async_playwright() as p: # ... # enter the CAPTCHA token to pass the block await page.evaluate( """ (captchaToken) => { const responseField = document.getElementById("g-recaptcha-response"); responseField.style.display = 'block'; responseField.value = captchaToken; responseField.dispatchEvent(new Event('change', { bubbles: true })); } """, captcha_token, )
This JavaScript code finds the hidden response field, makes it visible, sets the token value, and triggers a change event to notify the page that the CAPTCHA was solved.
After applying the CAPTCHA solution, you can proceed with your scraping tasks. Let’s verify the solution worked by clicking the submit button and checking the response:
Python
# ...import time# ...async def scraper(url): async with async_playwright() as p: # ... # confirm if the CAPTCHA is passed await page.get_by_role("button", name="Check").click() time.sleep(10) try: success_text = await page.text_content("p._successMessage_1ndnh_1") if success_text: print(success_text) else: error_text = await page.text_content("div._alertBody_bl73y_16") print(error_text) except Exception as e: print(e) # close the browser await browser.close()
The CSS selectors provided in this example (._successMessage_1ndnh_1, ._alertBody_bl73y_16) are specific to the page used in this guide. Selectors may vary across websites. For guidance on customizing selectors, refer to the CSS Extractor documentation. If you’re having trouble, the Advanced CSS Selectors Troubleshooting Guide can help resolve common issues.
Run the code using asyncio:
Python
# ...import asyncio# ...url = "https://2captcha.com/demo/recaptcha-v2"# run the scraperasyncio.run(scraper(url))
By integrating 2Captcha with ZenRows, you can reliably handle even the toughest CAPTCHAs and keep your scraping workflows running smoothly. Whether you use the Universal Scraper API or the Scraping Browser, this setup helps you automate CAPTCHA solving and reduce manual effort.
At a success rate of 99.93%, ZenRows bypasses the CAPTCHAs and other anti-bot measures commonly encountered during web scraping. However, interactive or in-page CAPTCHAs, such as those tied to form fields, may occasionally appear after bypassing the primary CAPTCHA. While this is rare, integrating 2Captcha provides an additional layer of stealth, ensuring even higher reliability and enhancing the already impressive 99.93% success rate.
Does the Universal Scraper API Integration Support All CAPTCHA Types?
ZenRows, when integrated with 2Captcha, natively supports solving reCAPTCHA and Cloudflare Turnstile, two of the most common CAPTCHA types.
