How to get started with CapMonster Node.js SDK

[evgeniykornev]

Q: How do I get an API key?
Create an account at capmonster.cloud, top up your balance, and copy your API key from the Dashboard.

Q: How do I create my first task?
Use createTask with the relevant task type — RecaptchaV2Task, TurnstileTask, or GeeTestTask — passing your API key and target website URL.

Q: How do I get the solved result?
Poll getTaskResult with the task ID returned by createTask. Most captchas resolve within 300ms–6s.

Q: Where can I ask questions or report issues?
Right here in Discussions for general questions, or in Issues for bugs. Full API reference: github.com/CapMonsterCloud/capmonster-captcha-solver-docs

[PramudithaN]

@evgeniykornev Thanks for putting this quick-start guide together!

For anyone who learns best by looking at code, here is a quick Node.js snippet putting the steps above together to solve a reCAPTCHA v2. It creates the task and polls for the result as recommended:

// Replace with your actual initialization method based on the SDK docs
const client = new CapMonsterClient('YOUR_API_KEY');

async function solveMyCaptcha() {
    try {
        console.log('1. Creating task...');
        // Create the task (Make sure to provide the correct website URL and site key)
        const taskId = await client.createTask({
            type: 'RecaptchaV2TaskProxyless',
            websiteURL: 'https://example.com',
            websiteKey: 'TARGET_SITE_KEY'
        });
        
        console.log(`Task created successfully. ID: ${taskId}`);
        console.log('2. Polling for result...');

        // Poll for the result
        let result;
        while (true) {
            result = await client.getTaskResult(taskId);
            
            if (result.status === 'ready') {
                console.log('Captcha Solved!');
                console.log('Token:', result.solution.gRecaptchaResponse);
                break;
            }
            
            // Wait 1 second before polling again to respect the 300ms-6s window
            await new Promise(resolve => setTimeout(resolve, 1000));
        }

    } catch (error) {
        console.error('Failed to solve captcha:', error.message);
    }
}

solveMyCaptcha();

Hope this helps someone get up and running even faster!