Proxy-seller
ProxyFree toolsContact sales
  • Documentation
  • PROXY-SELLER
    • Authorization
    • Actions with proxies
      • Retrieve active proxy
      • Export IPs in txt/csv/custom
      • IP replacement
      • Comment on IP
      • Extend proxies
      • Authorizations
        • List of authorizations
        • Create authorization
        • Change authorization
        • Delete authorization
    • Order actions
      • Complete information
      • Calculate the order
      • Place an order
    • Balance
    • Residential proxy
      • Get package information
      • Get all locations
      • Get existing IP list
      • Create list
      • Rename list
      • Change rotation settings
      • Delete list
      • Subaccounts (subusers)
        • Create subuser package
        • Update package
        • Get package information
        • Delete subuser's package
        • Retrieve existing IP lists
        • Create IP list
        • Rename created list
        • Change rotation
        • Delete list
        • Create a special list for API-TOOL
      • Session ID + TTL
        • Create a special list
        • Get all ISP codes
      • Cases (FAQ)
    • API - Changelog
    • SDK PHP
    • SDK NodeJS
    • SDK Phyton
    • SDK Java
    • SDK Golang
  • Mobile CRM
    • Get authorization key
    • Usage guides
      • How to Work with API Reference
      • Host Actions
        • All hosts info
        • List of host modems
        • Change host name
        • Reboot all modems
        • Export modems info
      • Modem Actions
        • Get all modems
        • Change modem IP
        • Set pause on modem
        • Set unpause on modem
        • Reboot modem
        • Change modem rotation
        • Limits on modem
        • Delete limits on modems
        • Delete modem
        • Send a report
      • Modem authorization (users)
        • Create authorization
        • Edit authorization
        • Modem authorizations
        • Authorization info
        • Limit authorization
        • Get limit authorization
        • Delete authorization
      • Modem action links
        • Direct links
        • Create domain
        • Approve domain
        • Edit domain
        • All client domain
        • Domain info
        • Delete domain
    • API Reference
      • Hosts
      • Modems
      • Modem authorization
      • Action links
      • Proxy limit
  • More guides
    • Youtube channel
    • Our blog
  • News, discounts
    • Reddit
    • Discord
    • Telegram
Powered by GitBook
On this page
  • Basic usage
  • User & password (Main package)
  • User & password (Resident Subuser)
  • Curl command line sample
  • Restrict exit IPs to a specific country
  • Restrict exit IPs to a specific subdivision
  • Restrict exit IPs to a specific city
  • Restrict exit IPs to a specific ISP
  • Restrict exit IPs to a specific ASN
  • Restrict exit IPs to a specific ZIP code
  • Session control
  • Session ID
  • Session time
  • Different geotargeting combinations
  1. PROXY-SELLER
  2. Residential proxy

Session ID + TTL

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

PreviousCreate a special list for API-TOOLNextCreate a special list

Last updated 3 months ago

Basic usage

Credentials:

  • Proxy host:

    • res.proxy-seller.com(NL)

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

  • 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

User & password (Resident Subuser)

Only via API

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


Curl command line sample

curl -v -x xxx:yyy@res.proxy-seller.com: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

Curl command line sample:

curl -v -x xxx_c_US:yyy@res.proxy-seller.com: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

Curl command line sample:

curl -v -x xxx_sd_1906:yyy@res.proxy-seller.com: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:yyy@res.proxy-seller.com: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:yyy@res.proxy-seller.com: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

Curl command line sample:

curl -v -x xxx_isp_51811:yyy@res.proxy-seller.com: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:yyy@res.proxy-seller.com: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:xxx@res.proxy-seller.com: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:yyy@res.proxy-seller.com: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:yyy@res.proxy-seller.com:10000 https://www.google.com

Example with a TTL of 15 minutes:

curl -v -x xxx_c_US_s_100_ttl_15m:yyy@res.proxy-seller.com:10000 https://www.google.com

Example with a TTL of with 1 hour:

curl -v -x xxx_c_US_s_100_ttl_1h:yyy@res.proxy-seller.com: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:yyy@res.proxy-seller.com:10000 https://www.google.com

Example with country, city, session.

curl -v -x xxx_c_US_city_New-York_s_100:yyy@res.proxy-seller.com:10000 https://www.google.com

Example with country, ASN.

curl -v -x xxx_c_US_asn_12271:yyy@res.proxy-seller.com:10000 https://www.google.com

PUT

The list with country code you can find .

The list with ID of subdivisions you can find .

The list with ID of ISPs you can find .

/resident/list/tools
/residentsubuser/list/tools
here
here
here