OS fingerprints are only available for ISP and datacenter proxies. For residential proxies, use OS-targeting.
Authentication
Send your API key in thex-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.windows, macos, linux, ios or android. Use none to remove the fingerprint: the proxies then use the server’s default.- Node.js
- Python
- cURL
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. Useplan 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.
The proxy IPs to change, 1 to 500 per request. They must belong to this subscription.
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
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.cURL
200 OK
Rate Limits
Each proxy’s OS can be changed once an hour, whether through its plan or on its own.Errors
Related
ISP Basics
Proxy format and authentication for ISP proxies.
Datacenter Basics
Proxy format and authentication for datacenter proxies.