As of October 7, 2026, Shifter has the largest pool of live US IPs, more than Oxylabs and Bright Data, at a fraction of the cost.Shifter now has the largest pool of live US IPs

See benchmarks
Start Free TrialLog In
Integration

Use Shifter with Node.js

Drop Shifter's residential and ISP proxies into any Node.js project in minutes. Works seamlessly with axios, the native fetch (Node 18+), got, undici, Puppeteer, and Playwright.

Quick Start

Install

npm install axios https-proxy-agent

Basic Usage

import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";

const proxyUrl =
  "customer-USERNAME-country-us-sid-123ABC:PASSWORD@p.shifter.io:443";
const agent = new HttpsProxyAgent(proxyUrl);

const { data } = await axios.get("http://ip-info.com/json", {
  httpsAgent: agent,
  proxy: false,
});

console.log(data);
// { ip: "154.16.xxx.xxx", city: "New York", country: "US", ... }

Features

Drop-in support for axios, native fetch, got, undici, node-fetch and any HTTP client that accepts a proxy URL or agent
Per-request rotation by default, with `sid` for sticky sessions and `ttl-N` for timed pins of N seconds
Headless browser support via Puppeteer and Playwright with one-line proxy configuration
HTTP, HTTPS, and SOCKS5 protocols on the same gateway endpoint
Geo-targeting in 195+ countries via username parameters — no extra SDK required
Compatible with TypeScript, ESM, CommonJS, and every Node.js LTS version from 14 onwards

Examples

axios + Geo-Targeted Sticky Session

Pin one residential IP for an entire user session by adding a `sid` to the username. Add `country-uk`, `city-london`, or `asn-7922` to target geographically.

import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";
import { randomBytes } from "node:crypto";

const sid = randomBytes(4).toString("hex");

const proxyUrl =
  `customer-USERNAME-country-uk-city-london-sid-${sid}-ttl-300:` +
  `PASSWORD@p.shifter.io:443`;

const client = axios.create({
  httpsAgent: new HttpsProxyAgent(proxyUrl),
  proxy: false,
  timeout: 30_000,
  headers: {
    "User-Agent":
      "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
  },
});

const login = await client.post("https://example.com/login", {
  email: "user@example.com",
  password: "secret",
});

const dashboard = await client.get("https://example.com/dashboard");
const orders = await client.get("https://example.com/orders");

console.log(login.status, dashboard.status, orders.status);

Native fetch (Node 18+) with undici

If you're on Node 18 or newer you don't need axios — use the global fetch with an undici ProxyAgent. Smallest possible footprint.

import { ProxyAgent, setGlobalDispatcher } from "undici";

const proxyAgent = new ProxyAgent({
  uri: "http://p.shifter.io:443",
  token: `Basic ${Buffer.from(
    "customer-USERNAME-country-us-sid-456DEF:PASSWORD",
  ).toString("base64")}`,
});

setGlobalDispatcher(proxyAgent);

const r = await fetch("https://api.example.com/products?page=1");
const json = await r.json();

console.log(json);

Puppeteer with Authenticated Proxy

Route Chromium through Shifter and authenticate via page.authenticate(). Combine `sid` with browser-level cookies to keep a stable session for the entire crawl.

import puppeteer from "puppeteer";

const PROXY_HOST = "p.shifter.io";
const PROXY_PORT = 443;
const PROXY_USER = "customer-USERNAME-country-de-sid-789GHI";
const PROXY_PASS = "PASSWORD";

const browser = await puppeteer.launch({
  args: [`--proxy-server=http://${PROXY_HOST}:${PROXY_PORT}`],
  headless: "new",
});

const page = await browser.newPage();
await page.authenticate({ username: PROXY_USER, password: PROXY_PASS });

await page.setUserAgent(
  "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
);

await page.goto("https://example.com", { waitUntil: "networkidle0" });

const title = await page.title();
const html = await page.content();

console.log(title, html.length, "bytes");

await browser.close();

Playwright (multi-browser)

Playwright's launch options accept proxies natively, with credentials inline. Same setup works for Chromium, Firefox, and WebKit.

import { chromium } from "playwright";

const browser = await chromium.launch({
  proxy: {
    server: "http://p.shifter.io:443",
    username: "customer-USERNAME-country-fr-city-paris-sid-ABC123",
    password: "PASSWORD",
  },
});

const context = await browser.newContext({
  userAgent:
    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
});

const page = await context.newPage();
await page.goto("https://example.com");

const headlines = await page.locator(".headline").allTextContents();

console.log(headlines);

await browser.close();
FAQ

Frequently asked questions

Common questions about using Shifter with Node.js.

Pass an https-proxy-agent (or http-proxy-agent for plain HTTP) on the httpsAgent option, and set proxy: false to make axios use the agent directly. The proxy URL format is `http://USER:PASS@p.shifter.io:443`. The same axios instance can then be reused across requests.

Yes. The global fetch in Node 18+ uses undici under the hood. Create an undici ProxyAgent with the proxy URI and the basic-auth token, then call setGlobalDispatcher(proxyAgent). Every fetch call after that will route through Shifter.

Add a session ID to the username — for example `customer-USERNAME-country-us-sid-123ABC`. Every request sharing the same sid will reuse the same residential IP. Add `ttl-300` to keep that IP for up to 300 seconds.

Yes. For Puppeteer, pass --proxy-server in the launch args and call page.authenticate() with the proxy credentials. For Playwright, set the proxy field on the launch options with server, username, and password — works identically across Chromium, Firefox, and WebKit.

Add country, region, city, and ASN selectors to the proxy username. For example `customer-USERNAME-country-uk-city-london-sid-456DEF` returns IPs in London. The same syntax works across every Node HTTP library — no SDK required.

No SDK is required. Shifter's gateway speaks standard HTTP / SOCKS5 over a single endpoint. Configure the proxy with whichever HTTP client you already use and you're done.
Get started

Start Using Shifter with Node.js

Add Shifter's 205M+ residential and ISP proxies to your Node.js stack in under 5 minutes. Per-request rotation, sticky sessions, and full Puppeteer / Playwright support.

Try Shifter for FreeSet up in minutes. Cancel anytime.