Residential IPs Integration Guide

1. Click “Customize and Control Google Chrome” menu.
2. Click “Settings” button’
3. Scroll down and click on “Show advanced settings…”
4. Scroll down and click on “Change proxy settings…” found under “Network”
5. Under “Internet Properties” window click “Lan settings” button.
6. Under “Local Area Network (LAN) Settings” window click on the Proxy server for your LAN” and enter your proxy settings.
7.  Click on “Advanced” button.
8. Type gw1.geosurf.io under HTTP proxy.
9. Define the required port for the desired country (full list found in GeoSurf residential dashboard).
10. Check “Use this proxy server for all protocols”.
11. Click OK and Apply to save the settings.

1. Open firefox.
2. Open settings menu → Click on options.
3. Click on Advanced tab.
4. Navigate to “Network”.
5. Click “settings” found under “Connections”.
6. Select Manual proxy configuration radio button.
7.  Type gw1.geosurf.io under HTTP proxy.
8. Define the required port for the desired country (full list found in GeoSurf residential dashboard).
9. Check “Use this proxy server for all protocols”.
10. Click OK.
11. Go to ipinfo.io and verify the IP you got is from the desired country.

1. Open Internet Explorer.
2. Click on the Internet Explorer Settings which is in the top-right corner of the browser window.
3. Click on Internet options.
4. Under “Internet Properties” window click “Lan settings” button.
5. Under “Local Area Network (LAN) Settings” window click on the Proxy server for your LAN” and enter your proxy settings.
6. Click on “Advanced” button.
7. Type gw1.geosurf.io under HTTP proxy.
8. Define the required port for the desired country (full list found in GeoSurf residential dashboard).
9. Check “Use this proxy server for all protocols”.
10. Click OK and Apply to save the settings.

PHP. file_get_contents
// PHP file_get_contents proxy example
// http://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 = “http://www.example.com”;

// 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
// http://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 = “http://www.example.com”;

$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
# http://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(‘http://www.example.com’)
urllib2.urlopen(‘http://www.example.com’)

Python. version 3.x
# Python 3 proxy example
# http://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(‘http://www.google.com’)
req.urlopen(‘https://www.google.com’)

# Ruby proxy example
# http://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://www.example.com")
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
// http://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://www.example.com/");
URLConnection con = url.openConnection();

// Java Apache HttpClient proxy example
// http://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://www.example.com");
 
HttpResponse response = httpclient.execute(httpget);

Example request a Romanian IP. for Curl -v –proxy gw1.geosurf.io:8181 “http://www.ipinfo.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.

Index.js:

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

// http://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 } ]}

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

The port range is US port + 2000 (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 US session persistence ports + 2000 (10231-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 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.

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

The port range is DE session persistence ports + 2000 (10080-12079 ), 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:10080“http://www.ipinfo.io”

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:12079 “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 DE port + 2000 (8080 -10079), 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 France residential session persistence, simply make a request to the France sticky ips gateway (fr-s1).

The port range is FR session persistence ports + 2000 (10072-12271), 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:10072 “http://www.ipinfo.io”

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:12071 “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 FR port + 2000 (8072-10071), 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 Great Britain residential session persistence, simply make a request to the Great Britain sticky ips gateway (gb-s1).

The port range is GB session persistence ports + 2000 (10229 -12228), 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:10229 “http://www.ipinfo.io”

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:12228“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 GB port + 2000 (8229 -10228), 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 India residential session persistence, simply make a request to the India sticky ips gateway (in-s1).

The port range is IN session persistence ports + 2000 (10099 – 12098), 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: 10099 “http://www.ipinfo.io”

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: 12098 “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 IN port + 2000 (8099 – 10098), 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 Thailand residential session persistence, simply make a request to the Thailand sticky ips gateway (in-s1).

The port range is TH session persistence ports + 2000 (10216 – 12215), 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: 10216 “http://www.ipinfo.io”

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: 12215 “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 TH port + 2000 (8099 – 10098), 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: 8099 “http://www.ipinfo.io”

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

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

…

Curl -v –proxy th-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.

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

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.

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

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

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 .

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

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.

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

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

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: