OS-Targeting

OS-targeting sends your requests through residential IPs on devices running a specific operating system. This helps when a site shows different content to desktop and mobile visitors, or when your client’s fingerprint should match the device, for example an Android user agent from an Android device.

OS-targeting works on its own or together with any location or ASN targeting.

Format

Add the os parameter to your username:

Username

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

string

required

Operating system of the exit device: windows, mac, linux, android or ios. Not case-sensitive.

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

These spellings also work: win for windows, macos and osx for mac, iphone and ipad for ios.

Combining With Other Targeting

You can combine os with country, state, city and asn. Put it after the location parameters and before the session ID:

Username

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

Android and iOS devices are usually on mobile networks, so they work well with a mobile carrier’s ASN. Every extra filter means fewer available IPs, so start with country and os and add more only if you need to.

Example Request

Python
cURL

Python

import requests

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

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

cURL

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

Dashboard

The proxy generator in your dashboard has an Operating System dropdown that adds the parameter for you.

Troubleshooting

PX1002 (502, no exit node available): no IPs match this OS together with your other filters. Remove city, state or asn first, then try another OS.
PX1004 (400, unsupported targeting option): the OS is not one of the names listed above.
See Error Handling for all proxy errors.

Getting Started

Residential Proxies

ISP Proxies

Datacenter Proxies

Reseller

Format

Combining With Other Targeting

Example Request

Dashboard

Troubleshooting

​Format

​Combining With Other Targeting

​Example Request

​Dashboard

​Troubleshooting

Format

Combining With Other Targeting

Example Request

Dashboard

Troubleshooting