how-to-solve-recaptcha-v2-enterprise-using-api

reCAPTCHA v2 Enterprise — CaptchaAI Example Pack

Full working example for solving reCAPTCHA v2 Enterprise using the CaptchaAI API.

Languages: Python, Node.js, PHP, Go, Java, C#, Ruby, Rust, Kotlin, Bash

Related article

This example accompanies the blog article: How to Solve reCAPTCHA v2 Enterprise Using API

Prerequisites

• A CaptchaAI account with API key (get one here)
• A target page with reCAPTCHA v2 Enterprise for testing
• One or more of: Python 3.8+, Node.js 16+, PHP 8.0+, Go 1.21+, Java 11+, .NET 8+, Ruby 3.0+, Rust 1.70+, Kotlin 1.9+, or Bash with curl and jq

Setup

1. Clone the repository:

   git clone https://github.com/CaptchaAI/CaptchaAI-Examples.git
   cd CaptchaAI-Examples/articles/how-to-solve-recaptcha-v2-enterprise-using-api

2. Copy the environment file and add your credentials:

   cp .env.example .env

3. Edit .env with your API key and target page details. If the target page includes a data-s attribute on the reCAPTCHA element, add that value to CAPTCHA_DATA_S.

4. Follow the language-specific setup below.

Python

cd python
pip install -r requirements.txt
python solve.py

Node.js

cd node
npm install
node solve.js

PHP

cd php
composer install
php solve.php

Go

cd go
go run solve.go

Java

cd java
javac Solve.java
java Solve

C#

cd csharp
dotnet run

Ruby

cd ruby
ruby solve.rb

Rust

cd rust
cargo run

Kotlin

cd kotlin
kotlinc solve.kt -include-runtime -d solve.jar
java -jar solve.jar

Bash

cd bash
chmod +x solve.sh
bash solve.sh

How it works

1. Submit — sends the sitekey, page URL, and enterprise=1 flag (plus optional data-s) to the CaptchaAI API
2. Poll — checks for the solution every few seconds (15 s initial wait, then every 5 s)
3. Receive — prints the g-recaptcha-response token for injection into the target form

Environment variables

Variable	Required	Description
CAPTCHAAI_API_KEY	Yes	Your CaptchaAI API key
CAPTCHA_SITEKEY	Yes	The data-sitekey from the target page
CAPTCHA_PAGEURL	Yes	Full URL of the page with the CAPTCHA
CAPTCHA_DATA_S	No	The data-s value if present on the page
POLL_INTERVAL	No	Seconds between polls (default: 5)
MAX_TIMEOUT	No	Max seconds to wait (default: 120)