how-to-solve-hcaptcha-using-api

hCaptcha — CaptchaAI Example Pack

Full working example for solving hCaptcha 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 hCaptcha Using API

Prerequisites

• A CaptchaAI account with API key (get one here)
• A target page with hCaptcha 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-hcaptcha-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.

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
bundle install   # optional — uses stdlib only
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

Environment variables

Variable	Description
CAPTCHAAI_API_KEY	Your CaptchaAI API key
CAPTCHA_SITEKEY	hCaptcha sitekey from the target page
CAPTCHA_PAGEURL	Full URL of the target page
POLL_INTERVAL	Seconds between polls (default: 5)
MAX_TIMEOUT	Maximum wait in seconds (default: 120)