API Documentation

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://arkham-solver.com/api"

def solve_hcaptcha(website_url, website_key, is_invisible=False):
    """
    Solve an hCaptcha challenge using Arkham Solver API
    
    Args:
        website_url (str): The URL of the page with the captcha
        website_key (str): The hCaptcha site key
        is_invisible (bool): Whether it's an invisible hCaptcha
        
    Returns:
        str: The solved captcha token
    """
    # Step 1: Create task
    create_task_payload = {
        "clientKey": API_KEY,
        "task": {
            "type": "HCaptchaTaskProxyless",
            "websiteURL": website_url,
            "websiteKey": website_key,
            "isInvisible": is_invisible
        }
    }
    
    response = requests.post(f"{BASE_URL}/createTask", json=create_task_payload)
    task_result = response.json()
    
    if task_result.get("errorId") != 0:
        raise Exception(f"Error creating task: {task_result}")
    
    task_id = task_result["taskId"]
    print(f"Task created: {task_id}")
    
    # Step 2: Get task result (with polling)
    get_result_payload = {
        "clientKey": API_KEY,
        "taskId": task_id
    }
    
    print("Waiting for solution...")
    while True:
        response = requests.post(f"{BASE_URL}/getTaskResult", json=get_result_payload)
        result = response.json()
        
        if result.get("errorId") != 0:
            raise Exception(f"Error getting result: {result}")
        
        if result.get("status") == "ready":
            print("Captcha solved!")
            return result["solution"]["gRecaptchaResponse"]
        
        time.sleep(3)  # Wait 3 seconds before trying again

# Example usage
if __name__ == "__main__":
    try:
        # Check balance first
        balance_payload = {"clientKey": API_KEY}
        balance_response = requests.post(f"{BASE_URL}/getBalance", json=balance_payload)
        balance_data = balance_response.json()
        
        if balance_data.get("errorId") == 0:
            print(f"Current balance: {balance_data['balance']} {balance_data['currency']}")
        else:
            print(f"Error checking balance: {balance_data}")
            exit(1)
        
        # Solve captcha
        website_url = "https://example.com"
        website_key = "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2"
        
        solution = solve_hcaptcha(website_url, website_key)
        print(f"Solution token: {solution[:30]}...")
        
    except Exception as e:
        print(f"Error: {e}")