Session ID + TTL

To use it, you need to create and use a special sheet: the API TOOL for each proxy list.

Basic usage

Credentials:

• Proxy host:

  • res.proxy-seller.com(NL)

  • us.res.proxy-seller.com(US)

  • asia.res.proxy-seller.com(JP-Tokyo)

  • asia2.res.proxy-seller.com(JP-Tokyo)

• Proxy port: 10000

• Proxy type: HTTPS/SOCKS5 ((auto-detected))

• Proxy user: xxx

• Proxy password: yyy

Attention:

For simultaneous requests, use different ports in the range 10000-10999.

Important note: Each IP address port corresponds to a unique IP address (e.g. 1.23.45.6:10005 and 1.23.45.6:10006 are different IPs).

User & password (Main package)

Only via API

To obtain a username and password, you must create a special list

PUT /resident/list/tools

User & password (Resident Subuser)

Only via API

To obtain a username and password, you must create a special list in your subaccoun

PUT /residentsubuser/list/tools

---

Curl command line sample

curl -v -x xxx:[email protected]:10000 https://www.google.com

For each request, a new exit IP address is allocated from the global IP pool.

Restrict exit IPs to a specific country

You can add country data to the login info as follows: xxx_c_US

Here, US is a two-letter country code as per ISO 3166-1

Country code is case-sensitive!

The list with country code you can find here.

Curl command line sample:

curl -v -x xxx_c_US:[email protected]:10000 https://www.google.com

Restrict exit IPs to a specific subdivision

You can add subdivision data to the login info as follows : xxx_sd_ID

The list with ID of subdivisions you can find here.

Curl command line sample:

curl -v -x xxx_sd_1906:[email protected]:10000 https://www.google.com

Restrict exit IPs to a specific city

You can add city data to the login info as follows: xxx_city_Paris

You can specify both country and city at the same time like: xxx_c_US_city_New-York.

Curl command line sample:

curl -v -x xxx_city_Paris:[email protected]:10000 https://www.google.com

City names:

Spaces in city names (e.g. New York) must be replaced with the minus sign (-). For example:

curl -v -x xxx_city_New-York:[email protected]:10000 https://www.google.com

Restrict exit IPs to a specific ISP

You can add ISP data to the login info as follows : xxx_isp_ID

The list with ID of ISPs you can find here.

Curl command line sample:

curl -v -x xxx_isp_51811:[email protected]:10000 https://www.google.com

Restrict exit IPs to a specific ASN

You can add ASN data to the login info as follows : xxx_asn_12389

Curl command line sample:

curl -v -x xxx_asn_12389:[email protected]:10000 https://www.google.com

Restrict exit IPs to a specific ZIP code

You can add ZIP code to the login info as follows : xxx_c_US_zip_10001

The ZIP code works only in combination with the country code.

Curl command line sample:

curl -v -x xxx_c_US_zip_10001:[email protected]:10000 https://www.google.com

Session control

Session ID

If you need to initiate requests from the same IP more than once (reuse the same IP), you can add a session ID to the login as follows: xxx_s_100

In this case, 100 is your session ID. You can use any alpha-numeric string as a session ID.

If you repeat the session ID in the subsequent requests, you’ll get the same exit IP as long as it stays online.

Time limit for inactive sessions - 60 minutes.

Curl command line sample:

curl -v -x xxx_c_US_s_100:[email protected]:10000 https://www.google.com

Session time

If you need to set up the session time (rotation), you can add a session time to the login with session ID as follows: xxx_s_100_ttl_30s

The ttl parameter goes along with the session ID and allows you to set the session time. The suffixes s (seconds), m (minutes), h (hours) can be used in this parameter. After the specified time has elapsed, a request within that session will cause it to be re-created, resulting in the assignment of a new IP address (it's an alternative method to set a custom rotation time for each session).

Example with a TTL of 10 seconds:

curl -v -x xxx_c_US_s_100_ttl_10s:[email protected]:10000 https://www.google.com

Example with a TTL of 15 minutes:

curl -v -x xxx_c_US_s_100_ttl_15m:[email protected]:10000 https://www.google.com

Example with a TTL of with 1 hour:

curl -v -x xxx_c_US_s_100_ttl_1h:[email protected]:10000 https://www.google.com

Different geotargeting combinations

You can also specify different targeting combinations - country, city, ISP, ASN, session - at the same time.

Example with country, city, ASN, session.

curl -v -x xxx_c_US_city_New-York_asn_12271_s_100:[email protected]:10000 https://www.google.com

Example with country, city, session.

curl -v -x xxx_c_US_city_New-York_s_100:[email protected]:10000 https://www.google.com

Example with country, ASN.

curl -v -x xxx_c_US_asn_12271:[email protected]:10000 https://www.google.com