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.
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
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.
Start your experience with our GeoSurf Premium Proxy!