A powerful HTTP client for Node.js based on libcurl with browser fingerprinting capabilities.
curl-cffi is a high-performance HTTP client library for Node.js built on libcurl. It provides both synchronous and asynchronous request methods with powerful browser fingerprinting capabilities, making it ideal for web scraping, API testing, and automation tasks that require browser simulation.
- Multiple Request Modes: Support for both synchronous and asynchronous requests
- Browser Fingerprinting: Simulate various browsers including Chrome, Firefox, Safari, Edge, and Tor
- Session Management: Maintain cookies and configurations across requests
- Rich Configuration Options: Comprehensive control over HTTP requests
- JA3/TLS Fingerprinting: Advanced TLS fingerprint simulation
- Web scraping with browser simulation
- API testing and integration
- Automated web interactions
- Network request debugging
- Bypassing basic anti-bot measures
npm install curl-cffi
const { req } = require('curl-cffi');
// Asynchronous request
async function makeGetRequest() {
try {
const response = await req.get('https://api.example.com/data', {
impersonate: 'chrome136' // Simulate Chrome 136
});
console.log('Status Code:', response.statusCode);
console.log('Response Data:', response.data);
} catch (error) {
console.error('Request failed:', error);
}
}
makeGetRequest();
curl-cffi supports both synchronous and asynchronous request modes:
// Synchronous request
const { CurlRequestSync } = require('curl-cffi');
const syncCurl = new CurlRequestSync();
// Asynchronous request with event-based implementation
const { CurlRequest } = require('curl-cffi');
const asyncCurl = new CurlRequest();
// Asynchronous request with timer-based implementation
const { CurlRequestLoop } = require('curl-cffi');
const loopCurl = new CurlRequestLoop();
const { CurlSession, CurlSessionSync, CurlSessionLoop } = require('curl-cffi');
// Session Request
const req1 = new CurlSession()
// Synchronous session implementation
const req2 = new CurlSessionSync()
// Timer-based session implementation
const req3 = new CurlSessionLoop()
// Use global interface to reuse connections and improve performance
const req1 = new CurlSession({impl: gimpl})
This project is licensed under the MIT License - see the LICENSE file for details.
Inspired by curl_cffi
libcurl curl-impersonate