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

API & Examples

PHP file_get_contents proxy example

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 = “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 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 = “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 version 2.x proxy example

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

Python version 3.x proxy example

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(‘http://www.google.com’)
req.urlopen(‘https://www.google.com’)

Ruby proxy example

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

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

Java apache HttpClient proxy example

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

Most simple CURL example

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.

Node.js CURL proxy example - Random country selection

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

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 and 10 minutes persistent session.

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}

10 Minute US Residential Sticky IPs 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 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.

US Residential 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 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.

Germany (DE) Residential 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 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.

10 Minute Germany (DE) Residential Sticky IPs 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 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.

France (FR) Residential 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 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.

10 Minute France (FR) Residential Sticky IPs 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 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.

Great Britain (GB) Residential 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 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.

10 Minute Great Britain (GB) Residential Sticky IPs 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 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.

India (IN) Residential 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 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.

10 Minute India (IN) Residential Sticky IPs 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 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.

Thailand (TH) Residential 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 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.

10 Minute Thailand (TH) Residential Sticky IPs 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 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.

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

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

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!