OS-Targeting

OS-targeting routes requests through residential IPs whose exit device runs a specific operating system. This is useful when a target site serves different content or applies different checks to desktop and mobile visitors, or when the fingerprint your client presents should match the device the request appears to come from (for example, an Android user agent from an Android device).

OS-targeting is independent of location: it can be used on its own, with any geo-targeting level, and with ASN-targeting.

Targeting Format

Add the os parameter to your proxy username:

client-{CLIENT_ID}-os-{OS}-session-{SESSION_ID}

string

required

Operating system of the exit device. One of windows, mac, linux, android or ios. Case-insensitive.

Operating system	Parameter
Windows	`os-windows`
macOS	`os-mac`
Linux	`os-linux`
Android	`os-android`
iOS	`os-ios`

A few common spellings are accepted as aliases and normalised for you: win for windows, macos and osx for mac, iphone and ipad for ios.

Combining With Other Targeting

os can be combined with country, state, city and asn. Place it after the location parameters and before the session ID:

client-{CLIENT_ID}-country-Germany-os-android-session-{SESSION_ID}

Mobile operating systems (android, ios) usually sit behind carrier networks, so they pair naturally with a carrier ASN. As with every extra constraint, the available IP pool shrinks — start with country plus os and refine only if needed.

Example Request

import requests

proxies = {
    'http': 'http://client-{CLIENT_ID}-country-Germany-os-android-session-fnzwtath:{PASSWORD}@residential.roundproxies.com:5000',
    'https': 'http://client-{CLIENT_ID}-country-Germany-os-android-session-fnzwtath:{PASSWORD}@residential.roundproxies.com:5000'
}

response = requests.get('https://api.ipify.org?format=json', proxies=proxies)
print(response.json())

curl -x "http://client-{CLIENT_ID}-country-Germany-os-android-session-fnzwtath:{PASSWORD}@residential.roundproxies.com:5000" \
  https://api.ipify.org?format=json

Dashboard

The residential proxy generator in your dashboard has an Operating System dropdown that adds the parameter for you, for both specific and random country targeting.

Troubleshooting

PX1002 (502, no exit node available) — no live IPs match the requested OS together with your other constraints. Drop city, state or asn first, then try another OS.
PX1004 (400, unsupported targeting option) — the OS value is not one of the supported names listed above.
See Error Handling for the full list of proxy errors.

Getting Started

Residential Proxies

ISP Proxies

Datacenter Proxies

Reseller

Reseller API

Targeting Format

Combining With Other Targeting

Example Request

Dashboard

Troubleshooting

​Targeting Format

​Combining With Other Targeting

​Example Request

​Dashboard

​Troubleshooting

Targeting Format

Combining With Other Targeting

Example Request

Dashboard

Troubleshooting