GeoSurf™ is a straight-forward a premium proxy service which enables users to send requests via 3 networks:
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. GeoSurf™ VPN, which changes the IP for the entire computer, will affect any applications that access the internet.
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.
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 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.
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.
Click here to set up and choose your Geosurf residential plan.
Currently we only support HTTP/S protocols.
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.
Yes, our browser extension, GeoSurf Pro™ is available for Chrome, Firefox and almost every chromium based browser
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.
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.
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.
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”.
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.
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.
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.
Yes, Geosurf Pro browser extension supports Both Residential IPs and Geosurf Premium network of Data Center IPs.
Yes, your account’s bandwidth usage & balance is calculated in real time and available on your API Traffic report.
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, check out our integration guide for detailed instructions for GSA search engine ranker 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.
Your account’s authorized IPs list is updated every 30 minutes.
The traffic logs are being updated every 20 minutes.
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, 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)
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, all our gateways support Username:Password authentication. Check out your dashboard for further instructions.
Yes, check out our integration guide for detailed instructions for Foxy Proxy integration.
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.
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.
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.
Yes, simply use our high rotation gateway and every request you send will be from a different IP address.
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.
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.
You can change your account password through the “Change Password” wizard found under “Account information”.
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.
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.
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.
Sure! At any time. You can contact us and we will cancel your subscription.
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 accept credit cards and Paypal (for the US market), Enterprise customers can also pay with wire transfer.
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.
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.
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!).
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.
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.
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 |
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*
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 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 check your up to date balance using the following API call:
curl -X GET https://api.geosurf.io/info/balance/${EMAIL}/${PASS}
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 payments history using the following request:
curl -X GET https://api.geosurf.io/info/payments/${EMAIL}/${PASS}
Please send an email to residential@geosurf.com and we’ll get back to you ASAP.
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:
Please contact your customer success manager or email us at residential@geosurf.com
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.
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.
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.
Another common case for this error is insufficiant funds, please contact your customer success manager or top up your account directly from the dashboard.
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.
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.
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.
