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.
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!
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.
If you signed up to GeoSurf™ static IPs, there 4 ways to use it:
If you signed up to GeoSurf™ Residential, there are 3 ways to use it:
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.
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.
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.
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.
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.
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
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:
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.
Start your experience with our GeoSurf Premium Proxy!