Residential IPs Integration Guide

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

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.

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

PHP. file_get_contents

// PHP file_get_contents 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”;

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

// 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 2 proxy example

# https://www.geosurf.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
# Python 3 proxy example
# https://www.geosurf.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
# https://www.geosurf.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
// https://www.geosurf.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
// https://www.geosurf.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);

Index.js:

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

// https://www.geosurf.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 } ]}

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}

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

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

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

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.

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?

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.

• 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

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.

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

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. Click here for additional information about sticky IPs.
   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”.

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

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

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

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

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.

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.

What is a DNS leak?

Why does it happen?

Troubleshooting