Residential IPs Integration Guide

Here you can find detailed information about GeoSurf™ Residential IPs integration. GeoSurf™ has an inbuilt IP rotation solution designed for easy integration. If you don’t find the right documentation for your needs, please fill in the contact us form and one of our representatives will be in touch.

Browser & OS Configuration

Internet Explorer, Chrome & Edge Browser

  1. Open Windows Explorer.
  2. Type in “Internet Properties”
  3. Click on “connections” tab.
  4. Navigate to “LAN settings”
  5. Check the first checkbox under “Proxy server”
  6. Click “Advanced”
  7. Fill in your proxy address (ex: gw1.geosurf.io) and port (ex: 8020) under HTTP.
  8. The “use the same proxy server” checkbox should be checked.
  9. Click OK and Apply to save your proxy settings.
  10. Go to ipinfo.io and verify the IP you got is from the desired country.

Mozilla Firefox

  1. Open Firefox.
  2. Click on the settings Icon found at the top right corner of the browser
  3. Navigate to “Network Proxy” and click on “Settings”
  4. Make sure that “Manual proxy configuration” is checked.
  5. Type your address (ex: gw1.geosurf.io) and port (ex: 8020) under HTTP.
  6. Check the “Use this proxy for all protocols” checkbox and click OK
  7. Verify your connection through ipinfo.io and make sure that the IP received is from the desired location.

Android Proxy configuration

  1. Navigate to Android settings >> “Wi-Fi” >> Press and hold “WiredSSID”
  2. Click “Modify Network”
  3. Under WiredSSID menu, tick “Show Advanced Options”
  4. Choose “Manual” in the drop down list under “Proxy”
  5. Input your Proxy hostname and Proxy port number under the appropriate fields
  6. Don’t forget to save and you’re done

* Use NOX player to simulate and test any configuration from your Desktop or Laptop computer.

API & Examples

PHP file_get_contents proxy example

PHP. file_get_contents
// PHP file_get_contents proxy example
// https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide

// Our gateway’s hosthname + port, check your dashboard for full gateways list
$gs_proxy_addr = “gw1.geosurf.io:8081”;

// Target URL
$url = “https://geo.geosurf.io”;

// Create file_get_contents context stream
$proxy_context_array = array(
‘http’ => array(
‘proxy’ => $gs_proxy_addr,
‘request_fulluri’ => TRUE
)
);
$proxy_context = stream_context_create($proxy_context_array);

// Use context stream with file_get_contents
$data = file_get_contents($url, FALSE, $context);

PHP cURL proxy example

PHP. cURL
// PHP cURL proxy example
// https://www.geosurf.com/resources/residential-ips-integration-guide

// Our gateway’s hosthname + port, check your dashboard for full gateways list
$gs_proxy_addr = “gw1.geosurf.io:8081”;

// Target URL
$url = “https://geo.geosurf.io”;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_PROXY, $gs_proxy_addr);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 1);
$curl_scraped_page = curl_exec($ch);
curl_close($ch);

Python version 2.x proxy example

Python 2 proxy example

# https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide
 
import urllib2
 
# Our gateway’s hosthname + port, check your dashboard for full gateways list
gs_proxy_addr = ‘gw1.geosurf.io:8081’
 
proxy = urllib2.ProxyHandler({
‘http’: gs_proxy_addr,
‘https’: gs_proxy_addr})
opener = urllib2.build_opener(proxy)
urllib2.install_opener(opener)
 
urllib2.urlopen(‘https://geo.geosurf.io’)
urllib2.urlopen(‘https://geo.geosurf.io)

Python version 3.x proxy example

Python. version 3.x
# Python 3 proxy example
# https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide

import urllib.request as req

# Our gateway’s hosthname + port, check your dashboard for full gateways list
gs_proxy_addr = ‘gw1.geosurf.io:8081’

proxy = req.ProxyHandler({

‘http’: gs_proxy_addr,
‘https’: gs_proxy_addr})

opener = req.build_opener(proxy)
req.install_opener(opener)

req.urlopen(‘https://geo.geosurf.io’)
req.urlopen(‘https://geo.geosurf.io’)

Ruby proxy example

# Ruby proxy example
# https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide

require "uri"
require 'net/http'

# Our reverse proxy hostname + port, check your address in Dashboard
gs_proxy_addr = 'gw1.geosurf.io'
gs_proxy_port = '8081'

uri = URI.parse("http://geo.geosurf.io")
proxy = Net::HTTP::Proxy(gs_proxy_addr, gs_proxy_port)

req = Net::HTTP::Get.new(uri.path)

result = proxy.start(uri.host,uri.port) do |http|
http.request(req)
end

puts result.body

Java global proxy example

// Java global proxy example
// https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide

System.setProperty("proxySet", "true");

// Our reverse proxy hostname + port, check your address in Dashboard
System.setProperty("http.proxyHost", "gw1.geosurf.io");
System.setProperty("http.proxyPort", "8081");

URL url = new URL("http://geo.geosurf.io/");
URLConnection con = url.openConnection();

Java apache HttpClient proxy example

// Java Apache HttpClient proxy example
// https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide

String gs_proxy_addr = "gw1.geosurf.io";
int gs_proxy_port = 8081;

DefaultHttpClient httpclient = new DefaultHttpClient();

HttpHost proxy = new HttpHost(gs_proxy_addr, gs_proxy_port , "http");
httpclient.getParams().setParameter(ConnRoutePNames.DEFAULT_PROXY, proxy);
 
HttpGet httpget = new HttpGet("http://geo.geosurf.io");
 
HttpResponse response = httpclient.execute(httpget);

Most simple CURL example

Example request a Romanian IP. for curl -v –proxy gw1.geosurf.io:8230“geo.geosurf.io”.

Log in to your dashboard to get a full list of our gateways and countries. Don’t forget to whitelist your machine IP, see instruction.

Node.js CURL proxy example - Random country selection

Index.js:

// Node.js CURL proxy example – Random country selection

// https://geosurf.staging.wpengine.com/resources/residential-ips-integration-guide

const request = require(‘request’)const gateways = require(‘./gateways’).gateways // or get the list via Geosurd residential IPs API call – https://api.client.geosurf.io/account/details/gateways
let countriesPorts = gateways.map(item => { return item.country_port})
let randomAddress = ‘gw1.geosurf.io:’ + countriesPorts[Math.floor(Math.random() * countriesPorts.length)]console.log(randomAddress)

// Use random address in your CURL request

Gateways.js:

module.exports = {module.exports = { ‘gateways’: [ { ‘cnt’: 6512, ‘ctr’: ‘IN’, ‘country_name’: ‘India’, ‘country_port’: 8099 }, { ‘cnt’: 2117, ‘ctr’: ‘DE’, ‘country_name’: ‘Germany’, ‘country_port’: 8080 }, { ‘cnt’: 1386, ‘ctr’: ‘FR’, ‘country_name’: ‘France’, ‘country_port’: 8072 }, { ‘cnt’: 1373, ‘ctr’: ‘US’, ‘country_name’: ‘United States’, ‘country_port’: 8230 }, { ‘cnt’: 1255, ‘ctr’: ‘BR’, ‘country_name’: ‘Brazil’, ‘country_port’: 8030 }, { ‘cnt’: 1154, ‘ctr’: ‘HU’, ‘country_name’: ‘Hungary’, ‘country_port’: 8097 }, { ‘cnt’: 1067, ‘ctr’: ‘IT’, ‘country_name’: ‘Italy’, ‘country_port’: 8106 }, { ‘cnt’: 977, ‘ctr’: ‘ES’, ‘country_name’: ‘Spain’, ‘country_port’: 8202 }, { ‘cnt’: 729, ‘ctr’: ‘AR’, ‘country_name’: ‘Argentina’, ‘country_port’: 8010 }, { ‘cnt’: 588, ‘ctr’: ‘TH’, ‘country_name’: ‘Thailand’, ‘country_port’: 8216 }, { ‘cnt’: 579, ‘ctr’: ‘VE’, ‘country_name’: ‘Venezuela’, ‘country_port’: 8236 }, { ‘cnt’: 460, ‘ctr’: ‘GB’, ‘country_name’: ‘United Kingdom’, ‘country_port’: 8229 }, { ‘cnt’: 454, ‘ctr’: ‘RO’, ‘country_name’: ‘Romania’, ‘country_port’: 8181 }, { ‘cnt’: 411, ‘ctr’: ‘MX’, ‘country_name’: ‘Mexico’, ‘country_port’: 8142 }, { ‘cnt’: 274, ‘ctr’: ‘CL’, ‘country_name’: ‘Chile’, ‘country_port’: 8043 }, { ‘cnt’: 270, ‘ctr’: ‘CO’, ‘country_name’: ‘Colombia’, ‘country_port’: 8047 }, { ‘cnt’: 210, ‘ctr’: ‘EC’, ‘country_name’: ‘Ecuador’, ‘country_port’: 8061 }, { ‘cnt’: 205, ‘ctr’: ‘PE’, ‘country_name’: ‘Peru’, ‘country_port’: 8173 }, { ‘cnt’: 188, ‘ctr’: ‘TW’, ‘country_name’: ‘Taiwan’, ‘country_port’: 8213 }, { ‘cnt’: 150, ‘ctr’: ‘TR’, ‘country_name’: ‘Turkey’, ‘country_port’: 8222 }, { ‘cnt’: 148, ‘ctr’: ‘JP’, ‘country_name’: ‘Japan’, ‘country_port’: 8110 }, { ‘cnt’: 124, ‘ctr’: ‘PH’, ‘country_name’: ‘Philippines’, ‘country_port’: 8174 }, { ‘cnt’: 123, ‘ctr’: ‘PL’, ‘country_name’: ‘Poland’, ‘country_port’: 8176 }, { ‘cnt’: 112, ‘ctr’: ‘RU’, ‘country_name’: ‘Russian Federation’, ‘country_port’: 8182 }, { ‘cnt’: 97, ‘ctr’: ‘VN’, ‘country_name’: ‘Vietnam’, ‘country_port’: 8237 }, { ‘cnt’: 91, ‘ctr’: ‘ID’, ‘country_name’: ‘Indonesia’, ‘country_port’: 8101 }, { ‘cnt’: 84, ‘ctr’: ‘SK’, ‘country_name’: ‘Slovakia’, ‘country_port’: 8196 }, { ‘cnt’: 81, ‘ctr’: ‘RS’, ‘country_name’: ‘Serbia’, ‘country_port’: 8192 }, { ‘cnt’: 81, ‘ctr’: ‘PT’, ‘country_name’: ‘Portugal’, ‘country_port’: 8177 }, { ‘cnt’: 76, ‘ctr’: ‘GR’, ‘country_name’: ‘Greece’, ‘country_port’: 8084 }, { ‘cnt’: 62, ‘ctr’: ‘HK’, ‘country_name’: ‘Hong Kong’, ‘country_port’: 8096 }, { ‘cnt’: 51, ‘ctr’: ‘MA’, ‘country_name’: ‘Morocco’, ‘country_port’: 8149 }, { ‘cnt’: 51, ‘ctr’: ‘UY’, ‘country_name’: ‘Uruguay’, ‘country_port’: 8232 }, { ‘cnt’: 47, ‘ctr’: ‘NL’, ‘country_name’: ‘Netherlands’, ‘country_port’: 8155 }, { ‘cnt’: 44, ‘ctr’: ‘KR’, ‘country_name’: ‘Korea, Republic of’, ‘country_port’: 8116 }, { ‘cnt’: 41, ‘ctr’: ‘PK’, ‘country_name’: ‘Pakistan’, ‘country_port’: 8167 }, { ‘cnt’: 40, ‘ctr’: ‘UA’, ‘country_name’: ‘Ukraine’, ‘country_port’: 8227 }, { ‘cnt’: 32, ‘ctr’: ‘IL’, ‘country_name’: ‘Israel’, ‘country_port’: 8105 }, { ‘cnt’: 29, ‘ctr’: ‘IR’, ‘country_name’: ‘Iran (Islamic Republic of)’, ‘country_port’: 8102 }, { ‘cnt’: 25, ‘ctr’: ‘SA’, ‘country_name’: ‘Saudi Arabia’, ‘country_port’: 8190 }, { ‘cnt’: 24, ‘ctr’: ‘MY’, ‘country_name’: ‘Malaysia’, ‘country_port’: 8133 }, { ‘cnt’: 23, ‘ctr’: ‘BG’, ‘country_name’: ‘Bulgaria’, ‘country_port’: 8033 }, { ‘cnt’: 23, ‘ctr’: ‘DZ’, ‘country_name’: ‘Algeria’, ‘country_port’: 8003 }, { ‘cnt’: 21, ‘ctr’: ‘CZ’, ‘country_name’: ‘Czech Republic’, ‘country_port’: 8055 }, { ‘cnt’: 19, ‘ctr’: ‘TN’, ‘country_name’: ‘Tunisia’, ‘country_port’: 8221 }, { ‘cnt’: 15, ‘ctr’: ‘PY’, ‘country_name’: ‘Paraguay’, ‘country_port’: 8172 }, { ‘cnt’: 15, ‘ctr’: ‘PS’, ‘country_name’: ‘Palestine’, ‘country_port’: 8169 }, { ‘cnt’: 14, ‘ctr’: ‘ET’, ‘country_name’: ‘Ethiopia’, ‘country_port’: 8067 }, { ‘cnt’: 14, ‘ctr’: ‘DK’, ‘country_name’: ‘Denmark’, ‘country_port’: 8056 }, { ‘cnt’: 14, ‘ctr’: ‘BE’, ‘country_name’: ‘Belgium’, ‘country_port’: 8021 }, { ‘cnt’: 12, ‘ctr’: ‘RE’, ‘country_name’: ‘Reunion’, ‘country_port’: 8180 }, { ‘cnt’: 12, ‘ctr’: ‘ZA’, ‘country_name’: ‘South Africa’, ‘country_port’: 8200 }, { ‘cnt’: 12, ‘ctr’: ‘AE’, ‘country_name’: ‘United Arab Emirates’, ‘country_port’: 8228 }, { ‘cnt’: 12, ‘ctr’: ‘AT’, ‘country_name’: ‘Austria’, ‘country_port’: 8014 }, { ‘cnt’: 11, ‘ctr’: ‘AU’, ‘country_name’: ‘Australia’, ‘country_port’: 8013 }, { ‘cnt’: 11, ‘ctr’: ‘SE’, ‘country_name’: ‘Sweden’, ‘country_port’: 8210 }, { ‘cnt’: 11, ‘ctr’: ‘EG’, ‘country_name’: ‘Egypt’, ‘country_port’: 8062 }, { ‘cnt’: 11, ‘ctr’: ‘DO’, ‘country_name’: ‘Dominican Republic’, ‘country_port’: 8059 }, { ‘cnt’: 10, ‘ctr’: ‘CN’, ‘country_name’: ‘China’, ‘country_port’: 8044 }, { ‘cnt’: 10, ‘ctr’: ‘LT’, ‘country_name’: ‘Lithuania’, ‘country_port’: 8127 }, { ‘cnt’: 10, ‘ctr’: ‘SG’, ‘country_name’: ‘Singapore’, ‘country_port’: 8195 }, { ‘cnt’: 10, ‘ctr’: ‘BA’, ‘country_name’: ‘Bosnia and Herzegovina’, ‘country_port’: 8027 }, { ‘cnt’: 9, ‘ctr’: ‘HR’, ‘country_name’: ‘Croatia (Hrvatska)’, ‘country_port’: 8052 }, { ‘cnt’: 9, ‘ctr’: ‘PA’, ‘country_name’: ‘Panama’, ‘country_port’: 8170 }, { ‘cnt’: 8, ‘ctr’: ‘NO’, ‘country_name’: ‘Norway’, ‘country_port’: 8165 }, { ‘cnt’: 8, ‘ctr’: ‘SD’, ‘country_name’: ‘Sudan’, ‘country_port’: 8206 }, { ‘cnt’: 6, ‘ctr’: ‘SI’, ‘country_name’: ‘Slovenia’, ‘country_port’: 8197 }, { ‘cnt’: 6, ‘ctr’: ‘CR’, ‘country_name’: ‘Costa Rica’, ‘country_port’: 8051 }, { ‘cnt’: 6, ‘ctr’: ‘BD’, ‘country_name’: ‘Bangladesh’, ‘country_port’: 8018 }, { ‘cnt’: 6, ‘ctr’: ‘CI’, ‘country_name’: ‘Ivory Coast’, ‘country_port’: 8107 }, { ‘cnt’: 6, ‘ctr’: ‘GE’, ‘country_name’: ‘Georgia’, ‘country_port’: 8079 }, { ‘cnt’: 6, ‘ctr’: ‘MD’, ‘country_name’: ‘Moldova, Republic of’, ‘country_port’: 8144 }, { ‘cnt’: 6, ‘ctr’: ‘OM’, ‘country_name’: ‘Oman’, ‘country_port’: 8166 }, { ‘cnt’: 6, ‘ctr’: ‘IQ’, ‘country_name’: ‘Iraq’, ‘country_port’: 8103 }, { ‘cnt’: 6, ‘ctr’: ‘SY’, ‘country_name’: ‘Syrian Arab Republic’, ‘country_port’: 8212 }, { ‘cnt’: 5, ‘ctr’: ‘MO’, ‘country_name’: ‘Macau’, ‘country_port’: 8129 }, { ‘cnt’: 5, ‘ctr’: ‘IE’, ‘country_name’: ‘Ireland’, ‘country_port’: 8104 }, { ‘cnt’: 5, ‘ctr’: ‘LY’, ‘country_name’: ‘Libyan Arab Jamahiriya’, ‘country_port’: 8125 }, { ‘cnt’: 4, ‘ctr’: ‘AO’, ‘country_name’: ‘Angola’, ‘country_port’: 8006 }, { ‘cnt’: 4, ‘ctr’: ‘MU’, ‘country_name’: ‘Mauritius’, ‘country_port’: 8140 }, { ‘cnt’: 4, ‘ctr’: ‘MK’, ‘country_name’: ‘Macedonia’, ‘country_port’: 8130 }, { ‘cnt’: 4, ‘ctr’: ‘LV’, ‘country_name’: ‘Latvia’, ‘country_port’: 8121 }, { ‘cnt’: 4, ‘ctr’: ‘SV’, ‘country_name’: ‘El Salvador’, ‘country_port’: 8063 }, { ‘cnt’: 4, ‘ctr’: ‘CA’, ‘country_name’: ‘Canada’, ‘country_port’: 8038 }, { ‘cnt’: 4, ‘ctr’: ‘QA’, ‘country_name’: ‘Qatar’, ‘country_port’: 8179 }, { ‘cnt’: 4, ‘ctr’: ‘SN’, ‘country_name’: ‘Senegal’, ‘country_port’: 8191 }, { ‘cnt’: 3, ‘ctr’: ‘NZ’, ‘country_name’: ‘New Zealand’, ‘country_port’: 8158 }, { ‘cnt’: 3, ‘ctr’: ‘GP’, ‘country_name’: ‘Guadeloupe’, ‘country_port’: 8087 }, { ‘cnt’: 3, ‘ctr’: ‘BH’, ‘country_name’: ‘Bahrain’, ‘country_port’: 8017 }, { ‘cnt’: 3, ‘ctr’: ‘KW’, ‘country_name’: ‘Kuwait’, ‘country_port’: 8118 }, { ‘cnt’: 3, ‘ctr’: ‘MN’, ‘country_name’: ‘Mongolia’, ‘country_port’: 8146 }, { ‘cnt’: 3, ‘ctr’: ‘KH’, ‘country_name’: ‘Cambodia’, ‘country_port’: 8036 }, { ‘cnt’: 3, ‘ctr’: ‘JM’, ‘country_name’: ‘Jamaica’, ‘country_port’: 8109 }, { ‘cnt’: 3, ‘ctr’: ‘ME’, ‘country_name’: ‘Montenegro’, ‘country_port’: 8147 }, { ‘cnt’: 3, ‘ctr’: ‘CH’, ‘country_name’: ‘Switzerland’, ‘country_port’: 8211 }, { ‘cnt’: 2, ‘ctr’: ‘KE’, ‘country_name’: ‘Kenya’, ‘country_port’: 8113 }, { ‘cnt’: 2, ‘ctr’: ‘LU’, ‘country_name’: ‘Luxembourg’, ‘country_port’: 8128 }, { ‘cnt’: 2, ‘ctr’: ‘CM’, ‘country_name’: ‘Cameroon’, ‘country_port’: 8037 }, { ‘cnt’: 2, ‘ctr’: ‘JO’, ‘country_name’: ‘Jordan’, ‘country_port’: 8111 }, { ‘cnt’: 2, ‘ctr’: ‘LB’, ‘country_name’: ‘Lebanon’, ‘country_port’: 8122 }, { ‘cnt’: 2, ‘ctr’: ‘MQ’, ‘country_name’: ‘Martinique’, ‘country_port’: 8138 }, { ‘cnt’: 2, ‘ctr’: ‘AZ’, ‘country_name’: ‘Azerbaijan’, ‘country_port’: 8015 }, { ‘cnt’: 2, ‘ctr’: ‘NC’, ‘country_name’: ‘New Caledonia’, ‘country_port’: 8157 }, { ‘cnt’: 2, ‘ctr’: ‘AM’, ‘country_name’: ‘Armenia’, ‘country_port’: 8011 }, { ‘cnt’: 2, ‘ctr’: ‘HN’, ‘country_name’: ‘Honduras’, ‘country_port’: 8095 }, { ‘cnt’: 2, ‘ctr’: ‘MT’, ‘country_name’: ‘Malta’, ‘country_port’: 8136 }, { ‘cnt’: 2, ‘ctr’: ‘NP’, ‘country_name’: ‘Nepal’, ‘country_port’: 8154 }, { ‘cnt’: 2, ‘ctr’: ‘GA’, ‘country_name’: ‘Gabon’, ‘country_port’: 8077 }, { ‘cnt’: 2, ‘ctr’: ‘GI’, ‘country_name’: ‘Gibraltar’, ‘country_port’: 8082 }, { ‘cnt’: 2, ‘ctr’: ‘KZ’, ‘country_name’: ‘Kazakhstan’, ‘country_port’: 8112 }, { ‘cnt’: 2, ‘ctr’: ‘AF’, ‘country_name’: ‘Afghanistan’, ‘country_port’: 8001 }, { ‘cnt’: 2, ‘ctr’: ‘CY’, ‘country_name’: ‘Cyprus’, ‘country_port’: 8054 } ]}

Sticky Residential IPs and Session Persistence

Session persistence overview


The requests are made by {key:value} pairs. The key represents the GateWay and the value represents the actual IP.

In our dashboard you will see all the different configurations for high rotation, 1 minute, 10 minutes and 30 minutes persistent sessions.

The Sticky country  gateways can be found in your dashboard.

Port ranges (value) are defined based on the following locig:

10 minutes sticky port values: +0 – + 2000

30 minutes sticky port values: +4001 – + 6000

1 minutes sticky port values: +2001 – + 4000

For example, if you want to form a list containing all our IPs in U.S. all you need to do is changing the values according to our available IPs in the dashboard.

U.S. IPs GateWay Key Example:

key = 'us-s1.geosurf.io'

U.S. IPs Port Value Example:

value = 10231

Proper Request Example:

>>> {key:value}

~~~ {'us-s1.geosurf.io': 10231}

List Of U.S. IPs Example:

{'us-s1.geosurf.io': 10231}

{'us-s1.geosurf.io': 10232}

{'us-s1.geosurf.io': 10233}

{'us-s1.geosurf.io': 10234}

.

.

{'us-s1.geosurf.io': 10352}

{'us-s1.geosurf.io': 10353}

US Residential 1 minute session persistence CURL example

To use the USA residential session persistence, simply make a request to the USA sticky ips gateway (us-s1).

The port range is 10231 – 12231, each port will assign you with a new Sticky IP which can be accessed for 1 minutes.

Example requests for a sticky residential IP in the United States:

Curl -v –proxy us-s1.geosurf.io:10231“http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:10232“http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:10233“http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:12230“http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

US Residential 10 minutes session persistence CURL example

To use the USA residential sticky IP, simply make a request to the USA sticky ips gateway (us-s1).

The port range is 8230 – 10230, each port will assign you with a new Sticky IP which can be accessed for 10 minutes.

Example requests for a sticky residential IP in the United States:

Curl -v –proxy us-s1.geosurf.io:8230 “http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:8231 “http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:8232 “http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:10229“http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

US Residential 30 minutes session persistence CURL example

To use the USA residential session persistence, simply make a request to the USA sticky ips gateway (us-s1).

The port range is 12232 – 14232, each port will assign you with a new Sticky IP which can be accessed for 30 minutes.

Example requests for a sticky residential IP in the United States:

Curl -v –proxy us-s1.geosurf.io:12232 “http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:12323 “http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:12234 “http://www.ipinfo.io

Curl -v –proxy us-s1.geosurf.io:14231 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Germany (DE) Residential 1 minute session persistence CURL example

To use the Germany residential session persistence, simply make a request to the Germany sticky ips gateway (de-s1).

The port range is 10081 – 12081, each port will assign you with a new Sticky IP which can be accessed for 1 minutes.

Example requests for a sticky residential IP in Germany:

Curl -v –proxy de-s1.geosurf.io:10081 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:10082 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:10083 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:12080 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Germany (DE) Residential 10 minute session persistence CURL example

To use the Germany residential sticky IP, simply make a request to the Germany sticky ips gateway (de-s1).

The port range is 8080 – 10080, each port will assign you with a new Sticky IP which can be accessed for 10 minutes.

Example requests for a sticky residential IP in Germany :

Curl -v –proxy de-s1.geosurf.io:8080 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:8081 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:8082 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:10079 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Germany (DE) Residential 30 minute session persistence CURL example

To use the Germany residential sticky IP, simply make a request to the Germany sticky ips gateway (de-s1).

The port range is 12082 – 14082, each port will assign you with a new Sticky IP which can be accessed for 30 minutes.
Example requests for a sticky residential IP in Germany :

Curl -v –proxy de-s1.geosurf.io:12082 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:12083 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:12084 “http://www.ipinfo.io

Curl -v –proxy de-s1.geosurf.io:14081 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

France (FR) Residential 1 minute session persistence CURL example

To use the France residential session persistence, simply make a request to the France sticky ips gateway (fr-s1).

The port range is 10073 – 12073, each port will assign you with a new Sticky IP which can be accessed for 1 minutes.

Example requests for a sticky residential IP in France:

Curl -v –proxy fr-s1.geosurf.io:10073 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:10074 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:10075 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:12072 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

France (FR) Residential 10 minute session persistence CURL example

To use the France residential sticky IP, simply make a request to the France sticky ips gateway (fr-s1).

The port range is 8072 – 10072, each port will assign you with a new Sticky IP which can be accessed for 10 minutes.

Example requests for a sticky residential IP in the France:

Curl -v –proxy fr-s1.geosurf.io:8072 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:8073 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:8074 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:10071 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

France (FR) Residential 30 minute session persistence CURL example

To use the France residential sticky IP, simply make a request to the France sticky ips gateway (fr-s1).

The port range is 12074 – 14074, each port will assign you with a new Sticky IP which can be accessed for 30 minutes.

Example requests for a sticky residential IP in the France:

Curl -v –proxy fr-s1.geosurf.io:12074 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:12075 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:12076 “http://www.ipinfo.io

Curl -v –proxy fr-s1.geosurf.io:14073 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Great Britain (GB) Residential 1 minute session persistence CURL example

To use the Great Britain residential session persistence, simply make a request to the Great Britain sticky ips gateway (gb-s1).

The port range is 10230 – 12230, each port will assign you with a new Sticky IP which can be accessed for 1 minutes.

Example requests for a sticky residential IP in Great Britain:

Curl -v –proxy gb-s1.geosurf.io:10230 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:10231 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:10232 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:12229“http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Great Britain (GB) Residential 10 minute session persistence CURL example

To use the Great Britain residential sticky IP, simply make a request to the Great Britain sticky ips gateway (gb-s1).

The port range is 8229 – 10229, each port will assign you with a new Sticky IP which can be accessed for 10 minutes.

Example requests for a sticky residential IP in the Great Britain:

Curl -v –proxy gb-s1.geosurf.io:8229 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:8230 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:8231 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:10228 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Great Britain (GB) Residential 30 minute session persistence CURL example

To use the Great Britain residential sticky IP, simply make a request to the Great Britain sticky ips gateway (gb-s1).

The port range is 12231 – 14231, each port will assign you with a new Sticky IP which can be accessed for 30 minutes.

Example requests for a sticky residential IP in the Great Britain:

Curl -v –proxy gb-s1.geosurf.io:12231 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:12232 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:12233 “http://www.ipinfo.io

Curl -v –proxy gb-s1.geosurf.io:14230 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

India (IN) Residential 1 minute session persistence CURL example

To use the India residential session persistence, simply make a request to the India sticky ips gateway (in-s1).

The port range is 10100 – 12100, each port will assign you with a new Sticky IP which can be accessed for 1 minutes.

Example requests for a sticky residential IP in India:

Curl -v –proxy in-s1.geosurf.io: 10100 “http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 10101 “http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io:10102 “http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 12099 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

India (IN) Residential 10 minute session persistence CURL example

To use the India residential sticky IP, simply make a request to the India sticky ips gateway (in-s1).

The port range is 8099 – 10099, each port will assign you with a new Sticky IP which can be accessed for 10 minutes.

Example requests for a sticky residential IP in India:

Curl -v –proxy in-s1.geosurf.io: 8099 “http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 8100 “http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 8101 “http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 10098 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

India (IN) Residential 30 minute session persistence CURL example

To use the India residential sticky IP, simply make a request to the India sticky ips gateway (in-s1).

The port range is 12101 – 14102, each port will assign you with a new Sticky IP which can be accessed for 30 minutes.

Example requests for a sticky residential IP in India:

Curl -v –proxy in-s1.geosurf.io: 12101 http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 12102 http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 12103 http://www.ipinfo.io

Curl -v –proxy in-s1.geosurf.io: 14101 http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Thailand (TH) Residential 1 minute session persistence CURL example

To use the Thailand residential session persistence, simply make a request to the Thailand sticky ips gateway (in-s1).

The port range is 10217 – 12217, each port will assign you with a new Sticky IP which can be accessed for 1 minutes.

Example requests for a sticky residential IP in Thailand:

Curl -v –proxy th-s1.geosurf.io: 10217 “http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 10218 “http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 10219 “http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 12216 “http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Thailand (TH) Residential 10 minute session persistence CURL example

To use the Thailand residential sticky IP, simply make a request to the Thailand sticky ips gateway (th-s1).

The port range is 8216 – 10216, each port will assign you with a new Sticky IP which can be accessed for 10 minutes.

Example requests for a sticky residential IP in Thailand:

Curl -v –proxy th-s1.geosurf.io: 8216 http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 8217 http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 8218 http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 10215 http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

Thailand (TH) Residential 30 minute session persistence CURL example

To use the Thailand residential sticky IP, simply make a request to the Thailand sticky ips gateway (th-s1).

The port range is 12218 – 14218, each port will assign you with a new Sticky IP which can be accessed for 30 minutes.

Example requests for a sticky residential IP in Thailand:

Curl -v –proxy th-s1.geosurf.io: 12218 http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 12219 http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 12220 http://www.ipinfo.io

Curl -v –proxy th-s1.geosurf.io: 14217 http://www.ipinfo.io

The process reloads every 30 min and assigns new IPs, even though the reload is very fast (less than 2 seconds) it is recommended to ping the gateway every 5 minutes for availability. Don’t forget to whitelist your machine IP, see instruction.

City & State Gateway

City Gateway overview

This service is currently available for all major US cities and we will continue to add more and more cities in the near future.

How it works?

·       Authentication – The authentication is done the same way as all other gateways, If your IP is whitelisted in our system you can start using the City gateway immediately.

·       City selection – The city gateway allows you to choose from 100 US cities, each city has its own port range.

·       Limits – Like all other GSR services you are unlimited with number of requests/sessions or connections, concurrent connections are limited to 20 per machine IP.

·       Gateway domain – us-city1.geosurf.io

Available Cities & Ports

Below is a list of all available cities, and their ports:

city state state_abbreviation start_port end_port
Albuquerque New Mexico NM 8000 8019
Arlington Texax TX 8020 8039
Athens Georgia GA 8040 8059
Atlanta Georgia GA 8060 8079
Auburn Alabma AL 8080 8099
Aurora Colorado CO 8100 8119
Austin Texas TX 8120 8139
Bakersfield California CA 8140 8159
Baltimore Maryland MD 8160 8179
Baton Rouge Louisiana LA 8180 8199
Beaverton Oregon OR 8200 8219
Bellevue Washington WA 8220 8239
Birmingham Alabama AL 8240 8259
Booneville Mississippi MS 8260 8279
Boston Massachusetts MA 8280 8299
Brooklyn New York NY 8300 8319
Buffalo New York NY 8320 8339
Charlotte North Carolina NC 8340 8359
Chicago Illinois IL 8360 8379
Cleveland Ohio OH 8380 8399
Colorado Springs Colorado CO 8400 8419
Columbia South Carolina SC 8420 8439
Columbus Ohio OH 8440 8459
Crowley Texax TX 8460 8479
Dallas Texas TX 8480 8499
Dayton Ohio OH 8500 8519
Decatur Georgia GA 8520 8539
Denver Colorado CO 8540 8559
Detroit Michigan MI 8560 8579
El Paso Texas TX 8580 8599
Fayetteville North Carolina NC 8600 8619
Fort Lauderdale Florida FL 8620 8639
Fort Worth Texas TX 8640 8659
Fremont California CA 8660 8679
Fresno California CA 8680 8699
Garwood New Jersey NJ 8700 8719
Glendale California CA 8720 8739
Harrisburg Pennsylvania PA 8740 8759
Henderson Nevada NV 8760 8779
Hollywood California CA 8780 8799
Honolulu Hawaii HI 8800 8819
Houston Texas TX 8820 8839
Indianapolis Indiana IN 8840 8859
Jackson Mississippi MS 8860 8879
Jacksonville Florida FL 8880 8899
Kansas City Missouri MO 8900 8919
Katy Texas TX 8920 8939
Lansing Michigan MI 8940 8959
Lapel Indiana IN 8960 8979
Las Vegas Nevada NV 8980 8999
Lexington Kentucky KY 9000 9019
Los Angeles California CA 9020 9039
Louisville Kentucky KY 9040 9059
Macon Georgia GA 9060 9079
Madison Wisconsin WI 9080 9099
Memphis Tennessee TN 9100 9119
Miami Florida FL 9120 9139
Milwaukee Wisconsin WI 9140 9159
Minneapolis Minnesota MN 9160 9179
Nashville Tennessee TN 9180 9199
New Orleans Louisiana LA 9200 9219
New York New York NY 9220 9239
Newark New Jersey NJ 9240 9259
Oakland California CA 9260 9279
Oklahoma City Oklahoma OK 9280 9299
Omaha Nebraska NE 9300 9319
Orlando Florida FL 9320 9339
Philadelphia Pennsylvania PA 9340 9359
Phoenix Arizona AZ 9360 9379
Pittsburgh Pennsylvania PA 9380 9399
Pompano Beach Florida FL 9400 9419
Portland Oregon OR 9420 9439
Prescott Valley Arizona AZ 9440 9459
Princeton New Jersey NJ 9460 9479
Raleigh North Carolina NC 9480 9499
Richmond Virginia VA 9500 9519
Rochester New York NY 9520 9539
Rockvale Colorado CO 9540 9559
Sacramento California CA 9560 9579
Saint James Missouri MO 9580 9599
Saint Paul Minnesota MN 9600 9619
Salem Massachusetts MA 9620 9639
Salt Lake City Utah UT 9640 9659
San Antonio Texas TX 9660 9679
San Diego California CA 9680 9699
San Francisco California CA 9700 9719
San Jose California CA 9720 9739
Seattle Washington WA 9740 9759
Shreveport Louisiana LA 9760 9779
Spokane Washington WA 9780 9799
Spring Texas TX 9800 9819
St Louis Missouri MO 9820 9839
Stockton California CA 9840 9859
Tacoma Washington WA 9860 9879
Tampa Florida FL 9880 9899
The Bronx New York NY 9900 9919
Tucson Arizona AZ 9920 9939
Wallingford Connecticut CT 9940 9959
Washington District of Columbia DC 9960 9979
Wichita Kansas KS 9980 9999

Simple CURL example

Here’s a simple CURL example for Miami Florida : curl-x us-city1.geosurf.io:9120 geo.geosurf.io

State Gateway Overview

This Residential IP Gateway that allows you to choose State’s IPs. This service is available for all 50 US states and Washington DC.

How it works?

·       Authentication – The authentication is done in the same way as all other gateways, so, if your IP is white-listed in our system you can start using the State gateway immediately

·       State selection – The State gateway allows you to choose from all states using “loc” proxy header.

·       Session persistence – The state gateway allows you to maintain session persistence and open multiple session using the “X-Session” proxy header.

·       Limits – Like all other GSR services you have unlimited number of requests/sessions or connections and unlimited concurrent connections.

·       Gateway domain – state.geosurf.io

What is the benefit of using Proxy headers?

Using proxy headers breaks us free from the limits forced by fixed gateway:port combinations and allows you to choose the session persistence interval and have multiple locations in the same gateway.

Session Persistence:

·       If you keep sending requests to the same session number, you can maintain the same IP for any amount of time.

·       If no request is sent to the same session number for more than 60 seconds, the connection will drop.

Multiple Locations in the same gateway:

·       Choosing the location is more intuitive, simple select the location using country and state ISO abbreviations and place it into “loc” proxy headers, for example, “loc: US-NY” for New York, USA.

Simple CURL example

Here’s a simple CURL example using an IP from New York, USA:

·       curl -x state.geosurf.io:8000 –proxy-header “loc: US-NY” –proxy-header “X-session: 12345-12345” geo.geosurf.io

Best Practices – Residential IPs API

When and Where Should I use Sticky IPs?

When should I use Sticky IPs?

You should use Sticky IPs when you must run sequential requests to the target domain or website in a single session.

Examples: Running requests to several web pages from the same website, Navigating through several web pages using the same session etc.

Why shouldn’t I use the high rotation gateway for this use case?

If you use the high rotation gateway the IP address will change for every request you make.

When you are making requests trying to retrieve information from multiple web pages on the same website you will get a high fail rate.

There are 2 factors were combined might cause a high fail rate in a high probability:

1. Statistics: You probably count a successful query only when you successfully get the data from all the web pages in that session.

Now assuming a 95% success rate for all IPs, and a query which consists of 10 web pages:

Running a single session consisting of 10 request, each one IPs with to the same target domain is like flipping a coin 10 times.

Except now the probability for success is 95% for each flip where you expect you get a success every time. The probability for that is 0.95^10 =~ 60%.

2. User behavior mismatch – It is highly unlikely that the same user runs 10 different consecutive queries from 10 different locations.

This behavior will be easily recognized by the target and your request will either be blocked or cloaked.

How will using Sticky IPs resolve it?

Using the right sticky IP time based on the session length for every query in the same session will solve the 2 issues, why?

o Statistics – You will be running all the requests from the same IP, so it’s not like flipping a coin every time (Variables are dependent)

o User behavior match – It’s reasonable for a user to go through several google pages for the same keyword using the same IP.

Choosing the correct sticky IPs time

The Correct sticky time is based on the required session length.

You should choose a sticky time which is higher then the session length, keeping in mind that residential IPs tend to be a bit slower than DataCenter IPs.

We also suggest adding a 20% safety factor.

For example: For a 30 seconds required session + 20% safety factor (36 sec), we suggest using the 1 minute sticky IP time.

For a 55 seconds required session + 20% safety factor (66 seconds), we suggest using the 10 minutes sticky IP time.

When and Where should I use the High Rotation gateway?

When and Where should I use the High Rotation gateway?

In short what is the High rotation gateway?

Whether you are using our residential IPs network or Premium Static IPs, choosing a location using high rotation gateway ensures that your request will be sent through a different IP whithin the specified location.

Why should I choose a location using the High rotation gateway?

There are 2 main reasons for using the high rotation gateway:

1) More locations – The high rotation gateway is configured to have all the available countries in the Residential IPs network

2) Inbuilt IP rotation  – The high rotation gateway is pre-configured with a round-robin IP rotation mechanism, this means that we take care of the IP rotation for you.

Each request will be sent through a different IP address within the set location.

What are the optimal usecases for High rotation?

1) If your use case is requires sending every request through a different IP.

2) Your are running on a single request per session model

If your use case requres longer session times or sending multiple requests from the same IP in a set ammount of time, you should consider using one of the Sticky IPs gateways.

3rd party software integration

Using Geosurf Residential IP proxy with GSA search engine ranker

In order to use Geosurf with GSA search engine ranker please follow the steps below:

  • Click on the “options” button
  • Select “Use Proxies” and then click on “Configure” button
  • Click “Add Proxy” and then select “Add Single Proxy”
  • Select “Web proxy” and enter our gateway’s hostname + port
  • Check your dashboard for full gateways list

Using Geosurf Geosurf Residential IP proxy with Foxy Proxy

Please follow the steps below:

  1. Download and install FoxyProxy from the Chrome store.
  2. Open the extension.
  3. Click on “Options”.
  4. Click on “proxies” tab found on the right sidebar.
  5. Within “proxies” menu, click on “Add new proxy”.
  6. Choose “Manual Proxy Configuration”
  7. Enter our gateway’s hostname + port “Host or IP Address” (Example gw1.geosurf.io port:8099 for India) and click save.
  8. Check your dashboard for full gateways list and country ports.
  9. Go to “Proxy mode” and select “Use gw1.. For all URLs” from the drop-down menu.
  10. Check the IP  – http://www.ip2location.com.

Using Geosurf Residential IP proxy with AIO Sneakers Bot

Please follow the steps below:

  1. Click on “Configure” found in the top menu.
  2. Select “Proxies”.
  3. Click on “New list” found on the bottom left side.
    1. Name the list under “List name”.
    2. Select “Normal Proxies” under “List Type”
    3. Specify the site you want to use Geosurf Residential Ips proxy on (you can also select “all sites”).
  4. Check “Enable proxy list”.
  5. Enter our gateway’s hostname + port “Host or IP Address” (Example gw1.geosurf.io port:8099 for India) and click save.
    1. If you wish to use a different IP for every HTTP request, use the global gateway + country port.
    2. If you wish to have session persistence and use the sameIP again within the desired time frame (1-10 minutes) use the Sticky IPs gateways. Click here for additional information about sticky IPs.
  6. Check your dashboard for full gateways list and country ports.
  7. Click “Save”.

Using Geosurf Residential IP proxy with EasyCop sneakers bot

Please follow the steps below:

  1. Click on “Tools” and then select “Proxy list”.
  2. Click on “Paste Proxies”.
  3. Enter our gateway’s hostname + port “Host or IP Address” (Example gw1.geosurf.io port:8099 for India) and click save.
    1. If you wish to use a different IP for every HTTP request, use the global gateway + country port.
    2. If you wish to have session persistence and use the sameIP again within the desired time frame (1-10 minutes) use the Sticky IPs gateways. See “Sticky IPs” for additional information.
    3. Check your dashboard for full gateways list and country Ports.
  4. Click on “Import” and verify the proxies are enabled (By default, all proxies will be enabled).
  5. Click “Save”.

Using Geosurf Residential IP proxy with NikeSlayer

Please follow the steps below:

  1. Click on the “proxies” tab
  2. On the down left corner, click on “Add” with the small server icon
  3. Fill in your Host:Port details username & password
  4. Adjust how many proxies you want to use per 1 task
  5. Test Your proxies to see if they operate as expected
  6. Once the proxies are added, click “save release”
  7. You will automatically be taken to the home page and are ready for the release

Using Geosurf Residential IP proxy with BetterNikeBot (BNB)

Please follow the steps below:

  1. Click on the “Add/Edit Proxies”
  2. Paste all you proxies – one proxy per line
  3. Check the “Do not allot real IP to any account” and click “OK”
  4. BNB will automatically check all proxies for successful connection

Using Geosurf Residential IP proxy with Supreme Bot

For every thread in Supreme Bot you have the option to allocate 1 proxy. Add the proxy in the following format:

IP:Port:User:Pass

Using Geosurf Residential IP proxy with Another Nike Bot

Please follow the steps below:

  1. Click Configure -> Proxies
  2. Press on New list to add your proxies
  3. Check “Enable this proxy list”
  4. Change list type to “normal proxies”
  5. Pick you desired site from the drop down menu
  6. Click save
  7. Check the “Test Proxies before using them”
  8. Repeat this process for allocating 20% of your proxies for “monitoring” (can be found in “list type”)

Using Geosurf Residential IP proxy with Sneaker Bot 2.0

Please follow the steps below:

  1. Select “proxies” from the settings menu
  2. Add your proxies and click save
  3. Select “Use proxy” from the settings menu
  4. Each proxy will be assigned automatically to 1 task. The more proxies you have’ the more potential tasks you can run in parallel

Using Geosurf Residential Proxy Network with StubTabs & ProxyTabs

In order to use Geosurf Residential proxy network with Subtabs you fist have to verify the following parameters: 

 

·         You’re Geosurf account is active and your balance is >0. 

·         Your computer’s IP is whitelisted in the Geosurf Residential Dashboard, click here to check if your IP is indeed whitelisted. 

·         Both StabTabs and ProxyTabs are installed on your Chrome browser, and your account in StubTabs is active, you can verify it if a green dot appears on StubTabs icon. 

 

After we verified all the above steps, lets start configuring Geosurf Proxy: 

 

Step 1) Sign out from your Google account. 

Step 2) Login to your StubTabs icon –> Notice that both of the extension icon are green: 

·         White – Not logged in. 

·         Green – Logged in. 

·         Red – Unauthorized (Incorrect login or your trial has ended)  

Step 3) Add the relevant domains that you want to use proxy settings under the “Manage Domains” section in Stubtabs menu by following the instructions below:

1.      Click on Manage Domains

2.      Type in the domains and click on (+) icon.

 

Step 4) Add Geosurf Residential Gateways under “Manage Proxies” within “ProxyTabs” menu:

Step 5) Add our Geosurf Residential Gateways & port combination, see full list in your dashboard.  

*Not that in ProxyTabs you should define HTTP protocol. 

Since our authentication is by IP whitelist there is no need to enter username/password. 

Step 6) Restart Chrome (#chrome://restart )

Step 7) Navigate to one of the added domains (we chose ipinfo.io for this example) , duplicate the tab and refresh.

Now you’re all set.

Thank you for choosing Geosurf Residential proxy network.

 

Connection problems

Are you behind a firewall?

Some hosting providers & system administrators will block outgoing access to Geosurf Residential ports. Check with your hosting provider or your IT department to find out how to whitelist the required ports. Full list found in GeoSurf residential dashboard .

Are you getting Connection Refused from AWS/EC?

You probably need to explicitly enable outgoing access to GeoSurf residential ports in your EC2 firewall/networking configuration (full list found in GeoSurf residential dashboard).

Are you getting 408 timeouts?

If a significant portion of your requests is timing out ( 408 response code), there are a few reasons this could happen:

  1. The network connection between you and our gateway or between the gateway and the IP is not stable.
    1. Try using another gateway (ex. gw2.geosurf.io) and see if it fixes the issue.
    2. Try switching an IP, simply end the session and make another request through our gateway (IP will rotate automatically)
  2. The request you are making takes a long time to load.
    1. Increase the request timeout using a within the request header.
    2. Switch an IP.
  3. The residential IPs has been blocked by the remote site.
    1. Although this rarely happens, switching an IP will resolve the issue.

If only a small percentage of your requests are getting a 408 response code, the optimal solution is to resend your requests with a short delay of at least 3 seconds in-between each request.

Are you getting error code(-7) or (-3) when making an API request?

Please make sure you are logged into Geosurf Residential IPs proxy Dashboard (client.geosurf.io) and try again.

Are you getting denied access errors?

Please make sure you have whitelisted the Machine IP in your Geosurf Residential IPs dashboard.

Do you have DNS leak issues?

What is a DNS leak?

When using a proxy service, it is important that all requests will be routed through the proxy service. Under certain circumstances, the operating system will continue to send residual portions of the request through the default ISP DNS servers.

Why does it happen?

Some of our customers are using third party IP-rotation services, the third party integration might be flawed and a residual request will be sent through the customer’s default ISP DNS server.

Troubleshooting

If you using Geosurf residential IPs manually in a browser, using our Chrome extension or a direct proxy configuration is the best way to go, check out a step by step integration guide to all common browsers.

Screenshots:

Wrong integration example

Sign up now
Start your experience with our GeoSurf Premium Proxy!