How to Identify and Submit reCAPTCHA Extra Parameters (v2/v3/Enterprise) | CapSolver Guide

When dealing with complex anti-bot and CAPTCHA challenges, especially Google's reCAPTCHA, simply providing the sitekey and pageurl is often not enough to successfully obtain a valid g-recaptcha-response. Many websites leverage additional parameters to enhance their security, requiring our automation solutions to accurately identify and submit this hidden data.

This article provides an in-depth exploration of the common extra parameters in reCAPTCHA, guides you on how to use professional tools like CapSolver to identify them, and offers a complete API submission example.

1. Core Concepts: Understanding reCAPTCHA's Extra Parameters

These parameters are typically set by websites to distinguish between normal users and automated programs. Their presence depends on the specific site configuration and the version of reCAPTCHA being used.

1.1. reCAPTCHA Version Differences

reCAPTCHA comes in several main types, each with different parameter requirements:

1.2. Key Extra Parameters Explained

Important Note: You should only include a parameter in your submission if you know its exact purpose and have confirmed its presence using a detection tool. Blindly adding parameters can lead to failed validation.

2. How to Accurately Identify reCAPTCHA Extra Parameters

The best way to identify these hidden parameters is by using a browser extension provided by a professional CAPTCHA solving service, such as CapSolver's Captcha Solver Auto Solve extension.

Step 1: Install the CapSolver Extension

1. For Chrome users: Install the Captcha Solver Auto Solve extension.
2. For Firefox users: Install the Captcha Solver Auto Solve extension.

Step 2: Use Developer Tools for Detection

1. Navigate to the website with the reCAPTCHA you need to solve.
2. Press F12 or right-click on the page and select "Inspect" to open the Developer Tools.
3. Switch to the CapSolver Captcha Detector tab.
   
4. Keep the CapSolver panel open and trigger the reCAPTCHA on the page (e.g., by clicking a login button or refreshing the page).
5. The extension will automatically capture and parse all the required parameters.

Step 3: Get the JSON Submission Data

Once the parameters are successfully captured, the CapSolver extension panel will immediately display the necessary information in JSON format. This JSON can be used directly in your API request, ensuring your task submission is complete and accurate.

List of Detectable Parameters:

• Website URL
• Site Key
• isInvisible
• pageAction
• isEnterprise
• isSRequired (indicates if s-data/enterprisePayload is needed)
• isReCaptchaV3
• Api Domain
• Anchor
• Reload

3. API Submission Example: Including Extra Parameters

CapSolver's API is designed to let you submit all detected parameters through a unified interface. Below is a Python example using the requests library to submit a reCAPTCHA Enterprise task, including extra parameters like enterprisePayload and apiDomain.

import requests
import time

# Your CapSolver API Key
API_KEY = "YOUR_CAPSOLVER_API_KEY"

# API endpoints
CREATE_TASK_URL = "https://api.capsolver.com/createTask"
GET_TASK_RESULT_URL = "https://api.capsolver.com/getTaskResult"

# Parameters detected by the CapSolver extension
site_key = "6Lc_a_xxxxxxxxxxxxxxxxxxxxxxx"
page_url = "https://example.com/login"
enterprise_payload = "s-data-payload-from-extension"

def solve_recaptcha():
    # 1. Create the task
    task_payload = {
        "clientKey": API_KEY,
        "task": {
            "type": "ReCaptchaV2EnterpriseTask",
            "websiteURL": page_url,
            "websiteKey": site_key,
            "enterprisePayload": {
                "s": enterprise_payload
            },
            "apiDomain": "www.recaptcha.net"
        }
    }

    try:
        response = requests.post(CREATE_TASK_URL, json=task_payload)
        response.raise_for_status()
        task_data = response.json()

        if task_data.get("errorId") == 0:
            task_id = task_data.get("taskId")
            print(f"Task created successfully. Task ID: {task_id}")

            # 2. Poll for the result
            while True:
                result_payload = {
                    "clientKey": API_KEY,
                    "taskId": task_id
                }
                result_response = requests.post(GET_TASK_RESULT_URL, json=result_payload)
                result_response.raise_for_status()
                result_data = result_response.json()

                if result_data.get("errorId") == 0:
                    status = result_data.get("status")
                    if status == "ready":
                        # Success! Get the token.
                        token = result_data["solution"]["gRecaptchaResponse"]
                        print(f"CAPTCHA solved! Token: {token[:30]}...")
                        return token
                    elif status == "processing":
                        print("Task is still processing, waiting...")
                        time.sleep(5)  # Wait for 5 seconds before checking again
                    else:
                        print(f"Task failed. Status: {status}")
                        return None
                else:
                    print(f"Error getting result: {result_data.get('errorDescription')}")
                    return None
        else:
            print(f"Error creating task: {task_data.get('errorDescription')}")
            return None

    except requests.exceptions.RequestException as e:
        print(f"An error occurred during the API request: {e}")
        return None

if __name__ == '__main__':
    solve_recaptcha()

Frequently Asked Questions (FAQ)

Q1: Why do I need to submit extra parameters?

A: Many websites use advanced features of reCAPTCHA, such as the Enterprise version or v3's behavior analysis, to enhance security. These features require additional context data from the client (like enterprisePayload or pageAction) to function correctly. If these parameters are missing, the reCAPTCHA service cannot properly evaluate the request, leading to task failure.

Q2: If I don't know if a parameter exists, should I try submitting it anyway?

A: This is not recommended. You should only submit a parameter when you have confirmed it is required using a tool like the CapSolver extension and have obtained its valid value. Submitting unnecessary or incorrect parameters can cause the API request to fail or return an invalid token.

Q3: What are the Anchor and Reload parameters? Do I need to parse them myself?

A: Anchor and Reload are auxiliary data points captured by the CapSolver extension in specific scenarios. You do not need to parse them manually. The value of the CapSolver extension is that it automatically detects and provides these parameters in a ready-to-use JSON format. Simply submit the complete parameter set provided by the extension to the CapSolver API.

Q4: What is the difference between reCAPTCHA v3's pageAction and v2's sitekey?

A:

• sitekey (v2/v3): This identifies the website and is a fundamental parameter required for all reCAPTCHA versions.
• pageAction (v3): This identifies the specific action the user is performing on the current page (e.g., login, checkout). reCAPTCHA v3 uses this action, along with the user's behavior, to return a risk score. This parameter is not used in v2.

Conclusion & Further Reading

Mastering the identification and submission of reCAPTCHA's extra parameters is crucial for successful automation. By leveraging professional tools and APIs like those from CapSolver, you can confidently tackle even the most complex CAPTCHA challenges.

Recommended Reading:

• CapSolver API Documentation - Learn more about reCAPTCHA task types and their parameters.
• How to Solve reCAPTCHA v3 - Get an in-depth look at the v3 scoring mechanism and solution.
• CapSolver Extension Tutorial - Learn how to maximize the extension's capabilities.

Redeem Your CapSolver Bonus Code

Don’t miss the chance to further optimize your operations! Use the bonus code CAPN when topping up your CapSolver account and receive an extra 5% bonus on each recharge, with no limits. Visit the CapSolver to redeem your bonus now!