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.

FAQ – 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 countries and cities and 30+ US DMA.
  • GeoSurf™ Mobile proxies - coming soon.
GeoSurf™ products suit enables users to send requests though our proxy network and view geo-targeted local content from other every country and city in the world. GeoSurf™ products suit includes: Residential IPs API, Static IPs API,  Browser extensions (Chrome & Firefox), Android and IOS applications. GeoSurf is also compatible with every 3rd party solution which requires proxies.
Yes, our browser extension, GeoSurf Pro™ is available for Chrome, Firefox and almost every chromium based browser.
Yes. GeoSurf™ VPN,  which changes the IP for the entire computer, will affect any applications that access the internet.

GeoSurf Static Locations: GeoSurf™ Static gateways are available in over 130 Countries and 30 US Designated Market Areas, GeoSurf™ Residential Locations: We have Residential IPs in 150+ countries and more than 1700 of cities around the world. We are constantly adding more IPs and locations to our network! Check out our available locations here.

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 was created in 2009 by BIScience, which also 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, we also have development centers in Romania and in Ukraine.

Sticky IPs are a way to maintain session persistence with a predefined time. We offer Sticky IPs in all our Residential IPs gateways allowing our customer to keep the same IP for 1/10/30 minutes. We have dedicated Sticky Residential IPs in all supported countries, states and cities! once you are logged in to your dashboard you will be able to see the full list of all available locations. Click here for more information & documentation.

GeoSurf allows you the ability to maintain session persistence. Our sessions connection feature allows you to bind your connection to a specific IP with no time limit! (with a TTL of 1/10/30 minutes) With sessions connections you can stick an IP to your device and keep it!

GeoSurf Pro browser extension is a cutting edge, easy-to-use, proxy solution combining residential IPs alongside with GeoSurf’s trusted premium proxies network in a single chrome & Firefox extension. GeoSurf Pro allows you to monitor geo-targeted local content, as if you were actually in these locations. GeoSurf Pro is a fast and reliable Residential and Data-Center IPs business proxy add on allowing you to switch between 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 terms of service.

Static IPs are IP addresses that do not change, they are data-center IPs which can easily get blocked if not used correctly . Residential IPs are based on real users, P2P network, making them undetectable and almost impossible to block.

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

Click here to set up and choose your Geosurf residential plan.

Yes, you can use the GeoSurf Residential on any machine you own and any IP associated with your account. For GeoSurf Residential usage, we charge only based on traffic usage.

Currently we only support HTTP/S protocols.

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. there is also an additional option to use 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 software 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 or check out our blog.


Getting Started

If you signed up to GeoSurf™ static IPs, there 4 ways to use it:

  • GeoSurf™ Browser extension: To download and install the latest version in chrome store.
  • 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:

  1. Send your requests through our API, click here for API examples page.
  2. Configure your browser to use GeoSurf™ Residential IPs, click here to learn more.
  3.  Configure GeoSurf™ Residential IPs with 3rd party software, contact us for additional information

For more general information about - Click here to check out GeoSurf Residential IPs integration guide.

In order to activate GeoSurf you must have an active subscription, if you don't have one, click here to purchase a subscription. If you do have an account, simply 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.

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 (manage IP's section)

Yes, your account’s bandwidth usage & balance is calculated in real time and available on your API Traffic report.

Each country got a high rotation port and 3 sticky IPs Gateways ( 1, 10, & 30 minutes sticky times). Just use the selected Gateway and the gateway will rotate the IPs for you based on the pre-defined sticky time. 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, all our gateways support Username:Password authentication. Check out your dashboard for further instructions.

Yes, check out our integration guide for detailed instructions for GSA search engine ranker integration.

Yes, check out our integration guide 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 by changing the port or session number.

Your account’s authorized IPs list is updated every 30 minutes.

Yes, you can make a request through a random country. Click here for a detailed Node.js CURL proxy example with a Random country selection.

The traffic logs are being updated every 20 minutes.

IP Selection & Performance

You can select an IP from all the suported countries, currently we support 1700+ cities. Check your dashboard for full list of supported cities or use our location API.

City IP is a premium feature,it's usage comes with a different pricing compared with your existing plan. Contact your customer success representative for additional information.

Yes, All users can use the 1 minute, 10 minutes & 30 minutes sticky option with no added costs! Simply use our sticky IP gateways, check out the API and examples section for more information. Or log in to your dashboard to see the full list of the available countries.

Soon , selecting the IP’s ISP is a premium feature for enterprise customers, contact your customer success representative for additional information.

You can keep the same IP for as long as you wish to (assuming its active), as long as you keep on sending requests before the TTL espires.

Yes, simply use our high rotation gateway and every request you send will be from a different IP address.


GeoSurf Dashboard

You can change your account password through the "Change Password" wizard found under "Account information".

You can add/remove or edit your IP whitelist in the "Manage IPs" section found under "Account Setting".

The following bulk actions will be available:

Set disabled – Check the active IPs you’d like to disable and click on the “Set Disabled” button.

Set enabled – Check the disabled IPS (marked in red) you’d like to re-enable and click on the “Set Enabled” button.

Remove – Check the IPs (enabled or disabled) you’d like to remove and click on the “Remove” button and re-confirm the action.

Yes, the Usage graph allows you to monitor your bandwidth consumption and filter it by date and metric directly in the dashboard home screen. The resolution will be determined by the selected time frame, the longer the time frame the lower the resolution.

Date range

Bandwidth resolution

Up to 24 hours

1-hour resolution

Up to 2 days

3-hour resolution

Up to 7 days

8-hour resolution

More than 7 days

1 day’s resolution

Another available filter is the Bandwidth units, you will be able to view your bandwidth consumption in MB, GB and TB.

Not sure which metrics to choose from? No worries! Our Dynamic Metric mode will choose the optimal one for you.

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.

You can reset your account's password through the "Forgot Password" section in the dashboard login page.

Having troubles resetting your password? contact your customer success manager or email us at residential@geosurf.com.

Sure! At any time. You can contact us and we will cancel your subscription.

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

The bandwidth calculated is the sum of the data going through our gateways (upload + download). This applies for both Geosurf Static and Residential IPs solutions.

For the purpose of our service bandwidth calculation, 1 GB equals 1000 MB, You can always use our API traffic report to inspect your usage - check out the API section for more information.

We have 2 pricing models for Geosurf Residential proxy:
Enterprise plans: The price model is based on a yearly subscription with a minimum monthly 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.

We accept credit cards and Paypal (for the US market), Enterprise customers can also pay with wire transfer.

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.

No, unused credit will not roll over from one billing cycle to the other.

The reason we work in this method is because we convert credits to GB and add it to your account at the beginning of every billing cycle and subtract it from our network capabilities.

Like all major SAAS companies, our plans are all based on pre-paid fixed auto recurring subscription fees. This means that your account is charged automatically every time a new billing cycle starts.


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/new/${EMAIL}/${PASS} -H ‘cache-control: no-cache’

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

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

Support

Please send an email to residential@geosurf.com and we’ll get back to you ASAP.

All payments goes through an authentication process, performed by our 3rd party payment & fraud detection partners. Once the process is complete the you will receive a confirmation e-mail conformation, and the funds will be added automatically to your account.

You must use the E-Mail associated with their account during the payment process, failing to do so will not allow the system to add the funds automatically. On those cases please contact your customer success manager to sort it out manually.

In most cases this it happens because your machine public IP is not whitelisted in the system. In order to verify your IP address is whitelisted in the system, please follow the steps below:

  1. Make sure there are no proxy active on the machine
  2. Go to geo.geosurf.io
  3. Copy the IP received there
  4. Log in to Geosurf Dashboard and navigate to “add IP” tab
  5. Add your machine IP there.
  6. Please note that the authentication process of a new IP may take up to 30 min

Another common case for this error is insufficiant funds, please contact your customer success manager or top up your account directly from the dashboard.

Please contact your customer success manager or email us at residential@geosurf.com

You are probably using IP white-list authentication, this message may indicate that your local machine IP is not white-listed in our system.
Log in to your dashboard to learn how to use Username/Password authentication or contact your customer success manager.

All our plans are automatically recurring. At the beginning of every recurring cycle, our payment processor will attempt to charge your account.

In case the transaction fails, your account will be automatically deactivated. Our payment processor will make several attempts to charge your account, and in case of a successful transaction your account will be automatically re-activated. Contact us if you have any questions.

Please verify that the IP you are adding is your public IP address and not your local IP address.

You can check your public IP here.

The IP is already white-listed in our system, please check the IP you are trying to add is not already white-listed in your account. If not, please contact your customer success manager or use Username / Password authentication.

Our finance department will issue out an invoice for each payment and will send it to the desired e-mail requested by the customer, in case no specific e-mail was requested the default will be the e-mail used for signing up the services.

Sign up now

Start your experience with our GeoSurf Premium Proxy!

Get Started