In this guide, we’ll walk you through setting up your ZenRows® Residential Proxies. You’ll learn how to create and access your credentials, including your username, password, and domain, which are essential for integrating the proxies into your applications.

Additionally, we’ll cover the available configuration options, such as World Region, Country, Protocol, and Sticky TTL, to help you optimize the use of the proxies based on your specific requirements.

​
Initial Setup

To get started with the Residential Proxies, follow these steps:

1

Sign Up for ZenRows®

To begin, you’ll need to create a ZenRows account. Visit the Registration Page to sign up. If you already have an account, simply log in to access your dashboard.

2

(Optional) Create Credentials for Residential Proxies

A credentials pair (user and password) will be created for you automatically, this step is not mandatory.

Once you’re signed in, navigate to the Credentials Page under the Residential Proxies section. Here, you can create credentials by specifying your proxy quota and generating your unique and password. You can create as many credentials as needed, allowing you to manage multiple projects easily!

3

Verify Credentials and Configure Your Proxies

After generating your credentials, you’ll be taken to the Generator Page, where your credentials — username, password, and various configuration options — will be displayed.

You can copy the Proxy URL and start integrating it into your applications.

​
Proxy Configuration Options

ZenRows Residential Proxies are designed to be functional right out of the box. With auto-rotation and residential IPs pre-configured, you can start using them immediately by copying the Proxy URL. However, we also provide additional customization options to help tailor the proxies to your use case.

Auto-rotate and Residential IPs are enabled by default for all users.

You can adjust the following configuration options:

​
Username and Password

To make proxy management easier, you can switch between usernames directly in the dashboard. Simply select the desired username, and the proxy URL will automatically update with the corresponding username and password. Note that the domain and port will remain the same.

​
World Region

If you need to target a specific geographic region, ZenRows allows you to customize your proxy requests by appending a region code to the proxy URL. This feature is essential for bypassing regional content restrictions or gathering region-specific data, such as localized pricing, availability, or website behavior.

To select a region, use region followed by the region code in your proxy URL. For example, if you want to target Europe, you would use -eu. The proxy URL will automatically update, granting you access to residential IPs from that specific area.

Example using a word region to Europe:

http://<YOUR_USERNAME>:<YOUR_PASSWORD>_region-eu@superproxy.zenrows.com:1337

Available Region Codes:

  • Europe: region-eu
  • North America: region-na
  • Asia Pacific: region-ap
  • South America: region-sa
  • Africa: region-af
  • Middle East: region-me

​
Country

If you need more precise control over the geographic location of your IPs, ZenRows allows you to target specific countries. This is only available when the World Region not set, giving you access to IPs from a specific country for enhanced geo-targeting.

ZenRows supports IPs from a wide variety of countries, allowing you to access geo-restricted data with ease. You can specify a country by using country followed by the country code in your proxy URL.

Example for Spain:

http://<YOUR_USERNAME>:<YOUR_PASSWORD>_country-es@superproxy.zenrows.com:1337
For a complete list of available countries, refer to our Premium Proxy Countries List

​
Protocol and Sticky TTL

ZenRows Residential Proxies support both HTTP and HTTPS protocols, giving you the flexibility to choose the best option depending on your scraping needs. You can also leverage the Sticky TTL (Time To Live) feature to control how long a particular IP address is assigned to your requests. This is especially useful for sessions requiring IP consistency over a certain time period.

With Sticky TTL, you can hold the same IP for durations ranging from 30 seconds to 1 day, ensuring more stable sessions for tasks such as login persistence or maintaining continuity across paginated data.

To enable sticky sessions, append the ttl parameter along with a session ID to your proxy credentials.

The session ID is a random string that uniquely identifies the session, allowing ZenRows to allocate the same IP for multiple requests. Currently, users need to generate this random session ID manually.

Example for a 30-second Sticky Session:

http://<YOUR_USERNAME>:<YOUR_PASSWORD>_ttl-30s_session-1cLiFzDgsq36@superproxy.zenrows.com:1337

In this example:

  • ttl-30s ensures the IP will be retained for 30 seconds.
  • session-1cLiFzDgsq36 is the session identifier, where 1cLiFzDgsq36 is a randomly generated string.

Available Sticky TTL Values:

  • 30 seconds: ttl-30s
  • 1 minute: ttl-1m
  • 30 minutes: ttl-30m
  • 1 hour: ttl-1h
  • 1 day: ttl-1d
IntroductionPython Requests