cdpfleet Pre-launch Get early access

cdpfleet / Residential proxy

Add-on · every plan

Residential IPs, priced by tier.

No proxy of your own? Send a cdpfleet-resi token as proxy and pick the price tier, exit country, device OS and whether the IP stays the same. One prepaid USD balance pays for every tier — from $0.50 to $5 per GB — and every account starts with $5 free credit.

  • 4price tiers
  • $0.50–$5per GB
  • $5free credit
  • Every planincluding Community

Four tiers, one balance

TierTokenPrice per GB
Tier 1cdpfleet-resi… (no tier) or cdpfleet-resi-tier-1…$5
Tier 2cdpfleet-resi-tier-2…$2.50
Tier 3cdpfleet-resi-tier-3…$1
Tier 4cdpfleet-resi-tier-4…$0.50

Pick the tier per token. Use Tier 1 for the pages that matter and a cheaper tier for bulk traffic such as CDN assets; the pools behind each tier can differ and may change. Country and sticky sessions work on every tier; device OS on Tier 1 and 2.

Top-ups add US dollars to your balance — any whole amount from $10 to $5,000 — and traffic is deducted at the price of the tier that carried it (1 GB = 10⁹ bytes, uploaded and downloaded). The balance doesn't expire.

Mix tiers per host

A session can send different hosts through different tiers with proxy_rules: pages on Tier 1, images, scripts and video from CDNs on Tier 4.

For example, 10 GB a month of which 8 GB is CDN assets costs $50 all on Tier 1, and $14 with the CDN hosts on Tier 4.

Per-host traffic in the dashboard shows which hosts carry the bytes, so you know what to move.

{
  "proxy": "cdpfleet-resi-country-us",
  "proxy_rules": [
    {
      "hosts": [
        "*.cloudfront.net",
        "*.akamaized.net",
        "static.*"
      ],
      "proxy": "cdpfleet-resi-tier-4-country-us"
    }
  ]
}

Targeting

PartValuesMeaning
-tier-N1, 2, 3, 4Price tier; Tier 1 if omitted.
-country-XXISO two-letter codeExit country; any if omitted.
-os-…windows, android, ios, macThe kind of device the residential IP belongs to.
-session-ID1–10 of A-Z a-z 0-9 _Sticky: the same IP for every connection; reuse the name in later browsers to keep it.
-lifetime-MIN1–1440How long a sticky IP is kept, in minutes.
The same German residential IP for up to 30 minutes
// npm install [email protected]
// Browsers run on cdpfleet, so no `npx playwright install` is needed.
import { chromium } from 'playwright';

const KEY = process.env.CDPFLEET_API_KEY;

// 1. Launch the browser
const res = await fetch('https://starter.cdpfleet.com/chromium/session', {
  method: 'POST',
  headers: { 'x-api-key': KEY, 'content-type': 'application/json' },
  body: JSON.stringify({
    proxy: 'cdpfleet-resi-country-de-session-cart1-lifetime-30',
    headless: 'new',
  }),
});
if (!res.ok) throw new Error(`launch failed: ${res.status} ${await res.text()}`);
const { wsUrl } = await res.json();

// 2. Connect and drive it
const browser = await chromium.connect(wsUrl, { headers: { 'x-api-key': KEY } });
const page = await browser.newPage();
await page.goto('https://example.com');
console.log(await page.title());
await browser.close(); // ends the session and stops billing

Good to know

  • The dashboard's Proxies → cdpfleet proxy page builds tokens, shows the balance and today's use per tier, and tops up through Stripe. The code generator offers the token too.
  • Traffic is metered about once a minute. With the balance used up, launches with a cdpfleet-resi token get 402 proxy_balance_exhausted; a running session may go $0.50 past zero before it is ended.
  • Use a token as the whole proxy or as one rule's proxy in proxy_rules — not inside a list of proxies.
  • Your own proxies stay free on every plan; the residential proxy is optional.