Advanced Filters

Learn how to filter Residential Proxies by operating system (OS) or IP version using advanced parameters.

Advanced filters let you narrow down your Residential Proxy pool by the operating system (OS) or Internet Protocol (IP) version:

• Platform (OS) – Select proxies that originate from a specific OS (Windows, iOS, etc.)
• IP Version – Select proxies that use only IPv4 or IPv6.

Platform (OS)

The platform parameter lets you select the operating system (OS) of the residential proxy for the Transmission Control Protocol (TCP) connection.

This can significantly improve your scraping success rates by ensuring your proxy and machine fingerprints match. For example, if your HTTP request emulates Google Chrome desktop but you are using an Android residential proxy, the target website may identify a fingerprint mismatch and handle such traffic.

To enable this feature, contact your Account Manager (details available in the Dashboard). You may need to complete a quick KYC procedure.

Usage

Add the platform parameter to your username string to specify the platform. It works alongside other parameters. Available values are:

• windows
• macos
• linux
• android
• ios

For instance, to get a proxy IP that comes from a Windows platform, your proxy username string should be: customer-USERNAME-platform-windows. Here's a complete cURL example:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-platform-windows:PASSWORD" https://ip.oxylabs.io/location

Residential Proxies are dynamic, so we cannot guarantee availability when combining the platform with specific locations (e.g., city, ZIP).

IP Version

By default, our Residential Proxies include both IPv4 and IPv6 addresses. If needed, you can select the Internet Protocol (IP) version to receive only IPv4 or IPv6 proxies.

To enable this feature, contact your Account Manager (details available in the Dashboard). You may need to complete a quick KYC procedure.

Usage

Add the ipversion parameter to your username string to specify the IP version. It works alongside other parameters.

• ipversion-4 selects proxies from the IPv4 pool
• ipversion-6 selects proxies from the IPv6 pool

For example, if you want to receive only IPv6 proxies, your username string should be: customer-USERNAME-ipversion-6. Here's a complete cURL example:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-ipversion-6:PASSWORD" https://ip.oxylabs.io/location

Residential Proxies are dynamic, so we cannot guarantee availability when combining the IP version with specific locations (e.g., city, ZIP).

If the target website does not support a specific IP version, our system will resolve the supported IP version where possible. For example, if you use the "IPv6 only" parameter with a website that only supports IPv4, the proxy may automatically resolve the target using IPv4 instead.

Reach out to your Account Manager to skip the automatic resolution and restrict the IP version to the selected one.

Error handling

If the target website does not support IPv6 you have disabled automatic resolution, you will receive a 522 error code. In that case, switch to IPv4 for the specific website or remove the ipversion parameter altogether.