API-TOOL

Basic usage

Credentials:

• Proxy host: res.proxy-sale.com

• Proxy port: 10000

• Proxy type: HTTPS/SOCKS5 (autodetected)

• Proxy user: xxx

• Proxy password: xxx

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:

From your proxy list

---

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

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 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

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