Frequently Asked Questions

We are committed to providing fast and reliable support for our users. Here you can find general information about GeoSurf™. If your question is not answered below, please fill in the contact us form and one of our representatives will be in touch.

General Questions

GeoSurf™ is a straight-forward a premium proxy service which enables users to send requests via 3 networks:
  • GeoSurf™ Residential IPs proxy network with more than 2 Million Residential IPs in every country and every city in the world.
  • GeoSurf™ Premium Static proxy network with servers in 130+ global locations and 30+ DMA’s.
  • GeoSurf™ Static proxy network with more than 10K static IPs in 20+ global locations
GeoSurf™ products enable users to surf and view geo-targeted local content from other areas. It also emulates many mobile devices. The service is available as a browser toolbar, VPN client, Direct Connect API, Residential IPs API, and smart phone connection.
We recommend using GeoSurf™ Toolbar on Chrome, Internet Explorer, Firefox, or Firefox for Mac. If you are looking for a solution to use GeoSurf™ on other browsers or Desktop applications, we offer to use GeoSurf™ VPN.
Yes. GeoSurf™ VPN, which changes the IP for the entire computer, will affect any applications that access the internet.
There are GeoSurf™ Static gateways in over 130 Countries and 30 US Designated Market Areas, and GeoSurf™ Residential IPs in 130 countries and hundreds of cities around the world. We are constantly adding more IPs and locations to our network! Click here to see how to get a list of available residential IPs in real time.
Our network boasts the highest levels of reliability, availability, and security. Because we own all of the servers on our network and host them in Tier 1 backbone data centers around the world, all of our users experience a totally secure browsing experience. We sign legally binding agreements with our customers to ensure their privacy.
GeoSurf is created by BIScience, a company that offers business intelligence solutions for online advertising activities. Our management team has roots in the online media business with experience and knowledge of what our customers need. We are legitimate and grounded – not a fly by night operation. Our corporate offices are in the heart of Tel Aviv and our staff is always available by phoneemailonline chatLinkedInFacebookTwitter.
Yes! Our mobile emulator gives you the option to surf the web as if you are using a mobile device. Using our Mobile emulator will enable you to validate, verify, and test web deployments on over 80 mobile devices and browser emulators with a click of a button using the GeoSurf Toolbar.
Sticky IPs are a way to maintain session persistence time with a predefined time. Our Sticky IP Residential IPs gateways support sticky IP session persistence allowing you to use the same IP for up to 10 minutes. We have dedicated Sticky Residential IPs gateways in the following countries: USAGermanyFranceUKIndiaThailand and more to come… Click here detailed documentation and API example, log in to your dashboard to see the full list of the available countries.
GeoSurf Pro Toolbar is a cutting edge, easy-to-use, proxy solution combining residential IPs alongside GeoSurf’s trusted premium proxies network in a single chrome & Firefox extension. GeoSurf Pro Toolbar let you view geo-targeted local content, as if you were actually in that location. In addition, it emulates mobile content and ads from a long list of mobile devices so you easily can view content and ads targeted at mobile users. GeoSurf Pro Toolbar is a fast and reliable Residential and DataCenter IPs business proxy add on with more than 2 million unique IPs worldwide.
You can use Geosurf Proxy network with almost any destination that supports HTTP/HTTPS protocol as long as your request complies with Geosurf’s terms of service.

Getting Started

If you signed up to GeoSurf™ static IPs, there 4 ways to use it:
  • GeoSurf™ Toolbar: To download and install the latest version of the toolbar, simply log in to your account and download the toolbar from the link on the left side.
  • GeoSurf™ Desktop VPN: To download and install the latest version,  log in to your account and download it.
  • GeoSurf™ Android VPN:  Click here to download it from Google Play store.
  • GeoSurf™ Direct connect API: Log in to your account and download the API documentation from your dashboard.
If you signed up to GeoSurf™ Residential, there are 3 ways to use it:
  • Send your requests through our API, click here for API examples page.
  • Configure your browser to use GeoSurf™ Residential IPs, click here to learn more.
  • Configure GeoSurf™ Residential IPs with 3rd party software, contact us for additional information
Click here check out GeoSurf Residential IPs integration guide.
Simply click the settings button and select the User Login tab. Then, enter your credentials as provided during the registration process.
Yes, Geosurf Pro browser extension supports Both Residential IPs and Geosurf Premium network of Data Center IPs.

Billing & Accounts

Sure! At any time. You can contact us and let us know what your needs are and we will transfer your account to the right package, or customize a package for your needs.
  1. Go to https://www.geosurf.com
  2. Click login at the top right
  3. Click “Forgot Password?”
  4. Enter your email address
  5. A new password will be emailed to you.
Yes! Login to your account by clicking Login at the top right of the website. There, you will see a link to cancel your account. As soon as you cancel, any future billing will be terminated.
These advanced features are available through our enterprise department. Simply contact us and let us know what you are interested in and a representative will be in touch with you to set up a plan with all the options you want (and none of the ones you don’t!). For these solutions, pricing is competitive and customized for your needs.
When you set up your account, your were assigned an Account Manager, who can handle all of these issues personally for you. Please contact your Account Manager with your specific request. If you are unsure who your Account Manager is, please contact us and we will take care of it for you..
The bandwidth calculated is the sum of the data going through our gateways (upload + download). This applies for both Geosurf Static andResidential IPs solutions. For the purpose of our service bandwidth calculation, 1 GB equals 1000 MB.

Geosurf Residential – Overview

Click here to set up and choose your Geosurf residential plan.
Yes, you can use the Geosurf Residential API on any machine you own and any IP associated with your account. For Geosurf Residential API usage, we charge only based on traffic usage.
Soon , selecting the IP’s ISP is a premium feature for enterprise customers, contact your customer success representative for additional information. Check out GeoSurf Residential IPs Integration Guide.
Yes, you can select an IP from all major US cities by using the City gateway. Check out GeoSurf Residential IPs Integration Guide for more information and request example. City IP is a premium feature, the city gateway’s usage comes with a different pricing compared with your existing plan. Contact your customer success representative for additional information.
Yes,  it’s easily accessible through an API, simply follow the steps below:
  1. Go to residential IPs dashboard – https://client.geosurf.io/#!/dashboard
  2. Login with your credentials
  3. Open developers console and reload the page
  4. Go to https://api.client.geosurf.io/account/details/gateways  to get list of countries with over 50 IPs
Yes, All users can use the 1 minute, 10 minutes & 30 minutes sticky option with no added costs! Simply use our sticky IP gateways, click here detailed documentation and API example. We currently have Sticky IP Gateways in 14 countries (and counting): Log in to your dashboard to see the full list of the available countries.
Currently we only support HTTP/S protocols.
Yes, HTTP & HTTPS protocols are supported.
All of the residential IPs are being checked every 5 minutes, this means that the chance of bend sent to a disconnected IP is close to 0%.
Please send an email to residential@geosurf.com and we’ll get back to you ASAP.
The traffic logs are being updated every 20 minutes.
Yes, you can! Most of our customers are actually have dynamic IPs. You can easily manage your IP white list using our dashboard or through our API. We there is also an additional option to purchase User:Password authentication as well, contact your customer success representative for additional information.
Yes! Geosurf Residential can be configured with a 3rd party software. If your sofware runs on a dedicated server or on your local machine – Simply add the machine IP to your IP white-list. If the software is cloud based – Contact your customer success manager to learn more about our username-password authentication solution.

Geosurf Residential – Getting started

Yes, click here for detailed instructions on changing your IP for all common browsers. Don’t forget to add your IP address to Geosurf Residential dashboard.
Yes, your account’s bandwidth usage & balance is calculated in real time and available on your dashboard.
Each country got a different port in our gateway. Just use the selected port and the gateway will rotate the IPs for you. A full list of gateways and ports are available in Geosurf residential dashboard, check out Residential IPs Integration guide.
Yes, IP address of every device / Machine which uses Geosurf should be authorized. The IP can be easily managed from our dashboard, click here to login to your dashboard.
Yes, click here for detailed instructions for GSA search engine ranker integration.
Yes, click here for detailed instructions for Foxy Proxy integration.
No, the requests will be sent as you specified it. If you wish to send a compressed request please specify it within your request.
This shouldn’t happen if you are using the service correctly, in a rare occasion it does, just request a new IP.
Your account’s authorized IPs list is updated every 10 minutes.
Yes, you can make a request through a random country, click here for an API example. Click here for a detailed Node.js CURL proxy example with a Random country selection.
WebRTC implement STUN (Session Traversal Utilities for Nat), a protocol that allows to discover the public IP address. To disable it: Mozilla Firefox: Type “about:config” in the address bar. Scroll down to “media.peerconnection.enabled”, double click to set it to false. Google Chrome: Install Google official extension WebRTC Network Limiter. Opera: Type “about:config” in the address bar or go to “Settings”. Select “Show advanced settings” and click on “Privacy & security”. At “WebRTC” mark select “Disable non-proxied UDP”.

Geosurf Residential API

Yes you can, use the following commands:

* Add IPs:

Request Type

Curl Example

GET

curl -v https://api.geosurf.io/accounts/ips/add/${EMAIL}/${PASS}?ips=ip1 !important;ip2 !important;ipn

* Remove:

Request Type

Curl Example

GET

curl -v https://api.geosurf.io/accounts/ips/remove/${EMAIL}/${PASS}?ips=ip1 !important;ip2 !important;ipn

Yes, you can check your up to date balance using the following API call:

curl -X GET https://api.geosurf.io/info/balance/${EMAIL}/${PASS}

Get a report for your account’ s traffic by running the following command:

curl - X GET https: //api.geosurf.io/info/bw_calc/report/${start_date}/${end_date}/${metric}/${EMAIL}/${PASS}

Meta description will include the start date and end date alongside with the selected metric and number of rows.

Each property includes the" upload", "download", "total" traffic for each of your account’ s IPs within a 10 minutes timeframe.

Expected response:

    [

        {

            "start_date": "2017 - 12 - 01 10",

            "end_date": "2017 - 12 - 28 23",

            "metric": "MB",

            "timestamp_delta": "10 MINUTES",

            "total_rows": 206,

            "max_rows": 5000

        },

        [

            {

                "upload": 0.003,

                "download": 0.075,

                "total": 0.078,

                "ts": "2017 - 12 - 27 13: 25: 29",

                "ip": "209.126 .107 .56"

            },

            {

                "
                upload": 0.003,

                "download": 0.075,

                "total": 0.078,

                "ts": "2017 - 12 - 27 13: 26: 12",

                "ip": "2012.123 .12 .1"

            },

        ]

    ]

Please make sure to use the following formats:

Metric format– GB / MB

Date format - YYYY - MM - DD HH

*Max rows allowed - 5000*

Get an aggregated report for your account's traffic by running the following command:

curl -X GET https://api.geosurf.io/info/bw_calc/report/${start_date}/${end_date}/${metric}/${EMAIL}/${PASS}?aggregated=true

Meta description will include the start date and end date alongside and the selected metric.

The bandwidth property includes the "sum_upload", "sun_download", "sum_total" traffic for each of your account's IPs within the defined timeframe.

Expected response:

{

    "start_date": "YYYY-MM-DD hh",

    "end_date": " YYYY-MM-DD hh",

    "metric": "GB",

    "bandwidth": {

        "sum_upload": 0.053,

        "sum_down": 0.632,

        "sum_total": 0.685

    }

}

Please make sure to use the following formats:

Metric format – GB / MB

Date format -YYYY-MM-DD HH

You can see your bandwidth usage in a month resolution using the following request:

curl -X GET https://api.geosurf.io/info/bw_calc/MM-YY/MM-YY/GB/${EMAIL}/${PASS}

Note: please use MM-YY date format

You can see your payments history using the following request:

curl -X GET https://api.geosurf.io/info/payments/${EMAIL}/${PASS}

You can get the available locations with sticky IPs, Gateway domain and port ranges using the following command:

curl -X GET https://api.geosurf.io/locations/sticky_ip/${EMAIL}/${PASS} -H ‘cache-control: no-cache’

Yes, You can get the available locations, gateways and port numbers using the below request:

curl -X GET https://api.geosurf.io/locations/ip_list/${EMAIL}/${PASS} -H ‘cache-control: no-cache’

Yes, You can get the available locations, gateways and port numbers using the below request:

curl -X GET https://api.geosurf.io/locations/ip_list/${EMAIL}/${PASS}?country=

Note: Please use 2 letter iso country code

Yes, You can get the daily active IPs per country by typing the following command:

curl -X GET https://api.geosurf.io/locations/ip_list/${EMAIL}/${PASS}?dau=true


GeoSurf Residential – Billing

We have 2 pricing models for Geosurf Residential proxy:
  • Enterprise plans: The price model is based on a yearly subscription with a minimum monthly bandwidth commitment, the higher the commitment the lower the rate per GB. Customers can exceed their minimum commitment at the same rate per GB.
  • SMB plans: The pricing model is “pay as you go” with a minimum monthly bandwidth commitment with auto renewal. Click here to check out Geosurf residential available SMB plans.

Yes, you can check your up to date balance using the following API call:

curl -X GET https://api.geosurf.io/info/balance/${EMAIL}/${PASS}

Yes, we mainly offer yearly subscriptions for Enterprise users, contact us to learn more.

We also offer pricing plans which are on a month-to-month basis; click here to choose your Geosurf residential plan.

No, our pricing model is based on bandwidth usage.

The price per GB is based on a minimum monthly / Yearly commitment, the higher the commitment the lower the rate we can offer.

Click here to choose a plan or contact our sales for additional information.

Sign up now

Start your experience with our GeoSurf Premium Proxy!

Get Started