Skip to main content
Every TCP connection carries a fingerprint of the operating system that opened it: the TTL, window size, MSS and other values in its first packet. Tools like p0f read it to guess the OS. If your browser says Windows but the connection looks like Linux, a site can notice the mismatch. You can give your ISP and datacenter proxies the TCP/IP fingerprint of Windows, macOS, Linux, iOS or Android. The setting applies only to your own credentials, so other customers on the same IP keep theirs. New credentials, for example after you rotate them, get the same setting.
OS fingerprints are only available for ISP and datacenter proxies. For residential proxies, use OS-targeting.

Authentication

Send your API key in the x-api-key header. You can find it in your dashboard.

Set the OS for a Plan

Sets the fingerprint of every proxy on one of your ISP or datacenter plans. Proxies that have their own OS (see below) keep it. Sending the same OS again re-applies it, which is also a way to resync. You can change a plan’s OS once an hour. It is also refused for an hour after you change a proxy that follows the plan’s OS.
string
required
The ID of your ISP or datacenter subscription.
string
required
windows, macos, linux, ios or android. Use none to remove the fingerprint: the proxies then use the server’s default.
Node.js
200 OK

Set the OS for Some Proxies

Gives some proxies on a plan their own OS, which wins over the plan’s. Use plan to remove it, so those proxies follow the plan’s OS again. Rotating credentials keeps the setting; a replacement IP starts on the plan’s OS. Each proxy’s OS can be changed once an hour, including by a change to the plan’s OS. Proxies changed in the last hour are skipped.
string
required
The ID of your ISP or datacenter subscription.
string[]
required
The proxy IPs to change, 1 to 500 per request. They must belong to this subscription.
string
required
windows, macos, linux, ios or android. none uses the server’s default even when the plan has an OS. plan follows the plan’s OS again.
cURL
The response has the same fields as above, plus:

Check a Proxy

Sends a request through one of your proxies, with your own credentials, to a passive fingerprinting server, and returns how its connection scores for each OS. Use it to confirm a change took effect.
string
required
The IP of one of your ISP or datacenter proxies.
cURL
200 OK

Rate Limits

Each proxy’s OS can be changed once an hour, whether through its plan or on its own.

Errors

ISP Basics

Proxy format and authentication for ISP proxies.

Datacenter Basics

Proxy format and authentication for datacenter proxies.
Last modified on November 18, 2026