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
| Tier | Token | Price per GB |
|---|---|---|
| Tier 1 | cdpfleet-resi… (no tier) or cdpfleet-resi-tier-1… | $5 |
| Tier 2 | cdpfleet-resi-tier-2… | $2.50 |
| Tier 3 | cdpfleet-resi-tier-3… | $1 |
| Tier 4 | cdpfleet-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
| Part | Values | Meaning |
|---|---|---|
-tier-N | 1, 2, 3, 4 | Price tier; Tier 1 if omitted. |
-country-XX | ISO two-letter code | Exit country; any if omitted. |
-os-… | windows, android, ios, mac | The kind of device the residential IP belongs to. |
-session-ID | 1–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-MIN | 1–1440 | How long a sticky IP is kept, in 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
# pip install playwright==1.60.0 requests
# Browsers run on cdpfleet, so no `playwright install` is needed.
import os
import requests
from playwright.sync_api import sync_playwright
KEY = os.environ["CDPFLEET_API_KEY"]
# 1. Launch the browser
res = requests.post(
"https://starter.cdpfleet.com/chromium/session",
headers={"x-api-key": KEY},
json={
"proxy": "cdpfleet-resi-country-de-session-cart1-lifetime-30",
"headless": "new",
},
timeout=60,
)
res.raise_for_status()
ws_url = res.json()["wsUrl"]
# 2. Connect and drive it
with sync_playwright() as p:
browser = p.chromium.connect(ws_url, headers={"x-api-key": KEY})
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close() # ends the session and stops billing
// Maven: com.microsoft.playwright:playwright:1.60.0 and com.google.code.gson:gson:2.11.0
// Run with PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1: browsers run on cdpfleet.
import com.google.gson.JsonParser;
import com.microsoft.playwright.*;
import java.net.URI;
import java.net.http.*;
import java.util.Map;
public class Example {
public static void main(String[] args) throws Exception {
String key = System.getenv("CDPFLEET_API_KEY");
// 1. Launch the browser
String body = """
{
"proxy": "cdpfleet-resi-country-de-session-cart1-lifetime-30",
"headless": "new"
}
""";
HttpResponse<String> res = HttpClient.newHttpClient().send(
HttpRequest.newBuilder(URI.create("https://starter.cdpfleet.com/chromium/session"))
.header("x-api-key", key)
.header("content-type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build(),
HttpResponse.BodyHandlers.ofString());
if (res.statusCode() != 200) {
throw new RuntimeException("launch failed: " + res.statusCode() + " " + res.body());
}
String wsUrl = JsonParser.parseString(res.body()).getAsJsonObject().get("wsUrl").getAsString();
// 2. Connect and drive it
try (Playwright playwright = Playwright.create()) {
Browser browser = playwright.chromium().connect(wsUrl,
new BrowserType.ConnectOptions().setHeaders(Map.of("x-api-key", key)));
Page page = browser.newPage();
page.navigate("https://example.com");
System.out.println(page.title());
browser.close(); // ends the session and stops billing
}
}
}
// dotnet add package Microsoft.Playwright --version 1.60.0
// Browsers run on cdpfleet, so no `playwright install` is needed.
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;
using Microsoft.Playwright;
var key = Environment.GetEnvironmentVariable("CDPFLEET_API_KEY")!;
// 1. Launch the browser
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", key);
var body = """
{
"proxy": "cdpfleet-resi-country-de-session-cart1-lifetime-30",
"headless": "new"
}
""";
var res = await http.PostAsync("https://starter.cdpfleet.com/chromium/session",
new StringContent(body, Encoding.UTF8, "application/json"));
if (!res.IsSuccessStatusCode)
throw new Exception($"launch failed: {(int)res.StatusCode} {await res.Content.ReadAsStringAsync()}");
var wsUrl = (await res.Content.ReadFromJsonAsync<JsonElement>()).GetProperty("wsUrl").GetString()!;
// 2. Connect and drive it
using var playwright = await Playwright.CreateAsync();
var browser = await playwright.Chromium.ConnectAsync(wsUrl, new BrowserTypeConnectOptions
{
Headers = new Dictionary<string, string> { ["x-api-key"] = key },
});
var page = await browser.NewPageAsync();
await page.GotoAsync("https://example.com");
Console.WriteLine(await page.TitleAsync());
await browser.CloseAsync(); // ends the session and stops billing
// go get github.com/playwright-community/[email protected]
//
// One-time driver setup (needs Node.js 18+): playwright-go can no longer download the
// 1.60.0 driver itself, so build it from npm and point PLAYWRIGHT_DRIVER_PATH at it:
// mkdir -p ~/.cache/pw-driver-1.60.0 && cd ~/.cache/pw-driver-1.60.0 &&
// curl -sL https://registry.npmjs.org/playwright-core/-/playwright-core-1.60.0.tgz | tar xz &&
// ln -sf "$(command -v node)" node
// export PLAYWRIGHT_DRIVER_PATH=~/.cache/pw-driver-1.60.0
// Browsers run on cdpfleet, so no browsers are downloaded (SkipInstallBrowsers).
package main
import (
"encoding/json"
"fmt"
"io"
"log"
"net/http"
"os"
"strings"
"github.com/playwright-community/playwright-go"
)
func main() {
key := os.Getenv("CDPFLEET_API_KEY")
// 1. Launch the browser
body := `{
"proxy": "cdpfleet-resi-country-de-session-cart1-lifetime-30",
"headless": "new"
}`
req, _ := http.NewRequest("POST", "https://starter.cdpfleet.com/chromium/session", strings.NewReader(body))
req.Header.Set("x-api-key", key)
req.Header.Set("content-type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
if res.StatusCode != http.StatusOK {
msg, _ := io.ReadAll(res.Body)
log.Fatalf("launch failed: %s %s", res.Status, msg)
}
var session struct {
WsURL string `json:"wsUrl"`
}
if err := json.NewDecoder(res.Body).Decode(&session); err != nil {
log.Fatal(err)
}
// 2. Connect and drive it (Install fetches only the Playwright driver, once)
opts := &playwright.RunOptions{SkipInstallBrowsers: true}
if err := playwright.Install(opts); err != nil {
log.Fatal(err)
}
pw, err := playwright.Run(opts)
if err != nil {
log.Fatal(err)
}
defer pw.Stop()
browser, err := pw.Chromium.Connect(session.WsURL, playwright.BrowserTypeConnectOptions{
Headers: map[string]string{"x-api-key": key},
})
if err != nil {
log.Fatal(err)
}
page, err := browser.NewPage()
if err != nil {
log.Fatal(err)
}
if _, err := page.Goto("https://example.com"); err != nil {
log.Fatal(err)
}
title, _ := page.Title()
fmt.Println(title)
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-resitoken get402 proxy_balance_exhausted; a running session may go $0.50 past zero before it is ended. - Use a token as the whole
proxyor as one rule's proxy inproxy_rules— not inside a list of proxies. - Your own proxies stay free on every plan; the residential proxy is optional.