How to solve reCaptcha v2 with Node.JS
Rajinder Singh
Deep Learning Researcher
27-Sep-2023
TL;DR
This guide explains how to solve reCAPTCHA v2 using Node.js with CapSolver’s API. It covers both proxyless and proxy-based implementations, includes step-by-step setup instructions, and provides ready-to-use Node.js code examples. By following this tutorial, developers can integrate reCAPTCHA v2 handling into their automation or data-collection workflows efficiently and reliably.
Introduction
reCAPTCHA v2 remains one of the most commonly deployed human-verification mechanisms across the web. For developers working with automated workflows, data extraction, or large-scale browser automation, handling reCAPTCHA v2 efficiently is a recurring technical challenge.
In this article, we walk through a practical Node.js implementation for solving reCAPTCHA v2 using the CapSolver API. You will learn how to configure your environment, install required dependencies, and implement solutions both with and without a proxy. The included examples are production-oriented and designed to be easily adapted to real-world use cases.
⚙️ Prerequisites
- Proxy (Optional)
- Node.JS installed
- Capsolver API key
🤖 Step 1: Install Necessary Packages
Execute the following commands to install the required packages:
python
npm install axios👨💻 Node.JS Code for solve reCaptcha v2 without proxy
Here's a Node.JS sample script to accomplish the task:
js
const axios = require('axios');
const PAGE_URL = ""; // Replace with your Website
const SITE_KEY = ""; // Replace with your Website
const CLIENT_KEY = ""; // Replace with your CAPSOLVER API Key
async function createTask(payload) {
try {
const res = await axios.post('https://api.capsolver.com/createTask', {
clientKey: CLIENT_KEY,
task: payload
});
return res.data;
} catch (error) {
console.error(error);
}
}
async function getTaskResult(taskId) {
try {
success = false;
while(success == false){
await sleep(1000);
console.log("Getting task result for task ID: " + taskId);
const res = await axios.post('https://api.capsolver.com/getTaskResult', {
clientKey: CLIENT_KEY,
taskId: taskId
});
if( res.data.status == "ready") {
success = true;
console.log(res.data)
return res.data;
}
}
} catch (error) {
console.error(error);
return null;
}
}
async function solveReCaptcha(pageURL, sitekey) {
const taskPayload = {
type: "ReCaptchaV2TaskProxyless",
websiteURL: pageURL,
websiteKey: sitekey,
};
const taskData = await createTask(taskPayload);
return await getTaskResult(taskData.taskId);
}
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
async function main() {
try {
const response = await solveReCaptcha(PAGE_URL, SITE_KEY );
console.log(`Received token: ${response.solution.gReCaptcharesponse}`);
}
catch (error) {
console.error(`Error: ${error}`);
}
}
main();👨💻 Node.JS Code for solve reCaptcha v2 with proxy
Here's a Node.JS sample script to accomplish the task:
js
const axios = require('axios');
const PAGE_URL = ""; // Replace with your Website
const SITE_KEY = ""; // Replace with your Website
const CLIENT_KEY = ""; // Replace with your CAPSOLVER API Key
const PROXY = "https://username:password@host:port";
async function createTask(payload) {
try {
const res = await axios.post('https://api.capsolver.com/createTask', {
clientKey: CLIENT_KEY,
task: payload
});
return res.data;
} catch (error) {
console.error(error);
}
}
async function getTaskResult(taskId) {
try {
success = false;
while(success == false){
await sleep(1000);
console.log("Getting task result for task ID: " + taskId);
const res = await axios.post('https://api.capsolver.com/getTaskResult', {
clientKey: CLIENT_KEY,
taskId: taskId
});
if( res.data.status == "ready") {
success = true;
console.log(res.data)
return res.data;
}
}
} catch (error) {
console.error(error);
return null;
}
}
async function solveReCaptcha(pageURL, sitekey) {
const taskPayload = {
type: "ReCaptchaV2Task",
websiteURL: pageURL,
websiteKey: sitekey,
proxy: PROXY
};
const taskData = await createTask(taskPayload);
return await getTaskResult(taskData.taskId);
}
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
async function main() {
try {
const response = await solveReCaptcha(PAGE_URL, SITE_KEY );
console.log(`Received token: ${response.solution.gRecaptchaResponse}`);
}
catch (error) {
console.error(`Error: ${error}`);
}
}
main();⚠️ Change these variables
- PROXY: Change to your proxy, only if you use ReCaptchaV2Task.
- CLIENT_KEY: Obtain your API key from the Capsolver Dashboard.
- PAGE_URL: Replace with the URL of the website for which you wish to solve captcha
- SITE_KEY: Replace with the site key of the page with captcha
👀 More information
Conclusion
Solving reCAPTCHA v2 in Node.js does not need to be complex. By leveraging the CapSolver API, developers can implement a clean, scalable solution that works reliably across different website configurations. Whether you choose a proxyless setup for simplicity or a proxy-based approach for greater control, the examples in this guide provide a solid foundation for production use.
FAQs
1. What is the difference between proxyless and proxy-based reCAPTCHA v2 tasks?
Proxyless tasks rely on CapSolver’s internal infrastructure and are simpler to implement, while proxy-based tasks allow you to control IP reputation and geographic location for higher success rates on stricter websites.
2. When should I use ReCaptchaV2Task instead of ReCaptchaV2TaskProxyless?
Use ReCaptchaV2Task when the target website enforces IP consistency or applies regional restrictions that require a specific proxy configuration.
3. How long does it usually take to receive a reCAPTCHA v2 token?
Most tasks are completed within a few seconds. Actual timing depends on site complexity, challenge difficulty, and whether a proxy is used.
4. Can this solution be integrated into larger Node.js automation systems?
Yes. The provided functions are modular and can be embedded into crawlers, automation pipelines, or browser-based workflows.
Compliance Disclaimer: The information provided on this blog is for informational purposes only. CapSolver is committed to compliance with all applicable laws and regulations. The use of the CapSolver network for illegal, fraudulent, or abusive activities is strictly prohibited and will be investigated. Our captcha-solving solutions enhance user experience while ensuring 100% compliance in helping solve captcha difficulties during public data crawling. We encourage responsible use of our services. For more information, please visit our Terms of Service and Privacy Policy.
More
Best reCAPTCHA Solver 2026 for Automation & Web Scraping
Discover the best reCAPTCHA solvers for automation and web scraping in 2026. Learn how they work, choose the right one, and stay ahead of bot detection.
Anh Tuan
14-Jan-2026
Top 5 Captcha Solvers for reCAPTCHA Recognition in 2026
Explore 2026's top 5 CAPTCHA solvers, including AI-driven CapSolver for fast reCAPTCHA recognition. Compare speed, pricing, and accuracy here
Lucas Mitchell
09-Jan-2026
Solving reCAPTCHA with AI Recognition in 2026
Explore how AI is transforming reCAPTCHA-solving, CapSolver's solutions, and the evolving landscape of CAPTCHA security in 2026.
Ethan Collins
08-Jan-2026
How to Identify and Obtain reCAPTCHA “s” Parameter Data
Learn to identify and obtain reCaptcha 's' data for effective captcha solving. Follow our step-by-step guide on using Capsolver's tools and techniques.
Ethan Collins
25-Nov-2025
How to Identify and Submit reCAPTCHA Extra Parameters (v2/v3/Enterprise) | CapSolver Guide
Learn how to detect and submit extra reCAPTCHA parameters using CapSolver to improve accuracy and solve complex challenges.
Rajinder Singh
10-Nov-2025
How to Solve reCAPTCHA When Scraping Search Results with Puppeteer
Master the art of Puppeteer web scraping by learning how to reliably solve reCAPTCHA v2 and v3. Discover the best puppeteer recaptcha solver techniques for large-scale data harvesting and SEO automation.
Lucas Mitchell
04-Nov-2025