Quick Start Guide - How do I use the proxies?
Welcome to Geonode, the one-stop shop for all your proxy needs. Geonode is an ever-growing proxy network offering rotating residential proxies without any data caps or data transfer limits. It supports HTTP, HTTPS, SOCKS4, SOCKS4A, and SOCKS5 protocols and straightforward configuration options. Moreover, Geonode residential proxies facilitate any web extraction needs from simple web scraping to extensive market research and even targeted eCommerce data gathering.
Where to get API key
We have to authenticate before starting to use the Geonode proxy. These authentication details (The API Key) can be easily found in the Authentication details section of the Geonode dashboard.
Login to Geonode Dashboard (https://app.geonode.com/login)
Then click on Dashboard on the left sidebar to navigate to the Authentication details section. There, we can find both the Username and API key, which are required for authentication.
NOTE - If you need a new API key, simply click on Whitelist IP on the sidebar and then click Generate new API key button to generate a new API key.
How to Whitelist an IP
You can whitelist specific IPs if you need to authenticate the proxy service without providing the Username and the API Key all the time. You can whitelist up to 150 IP addresses through which you can connect to the proxy without having to provide any additional authentication details. Follow these instructions to correctly whitelist your IP address.
1) Once logged into your Geonode Dashboard, click on Whitelist IP on the sidebar.
2) Enter IP Address to be Whitelisted and press Add.
3) Your successfully added addresses will be listed as shown above.
4) In case you need to remove any of the whitelisted addresses, click Remove. Any successful additions or removals will be confirmed by a toast message that is automatically displayed on the top-right of your dashboard after the exercise:
NOTE - Please allow up to 5 minutes for the Whitelisted IP to be reflected in the system.
Geonode Proxy usage examples (Python 3)
Geonode Proxy Request using Username/API Key (Credentials are required)
Geonode Proxy Request through the whitelisted IP (Credentials are not required when the connection is originated from the whitelisted IP)
Where to find API docs
You can find the complete API documentation regarding the Geonode proxies at the following URL: API Documentation.
Know how many threads are available in your plan
Users can see the number of available and currently in-use threads in the Threads panel on the homepage of the Geonode dashboard. Please refer to the Geonode documentation for more information about threads.
Note - The number of available threads depends on the subscribed service level. The following CURL command can be used to get the currently active threads in the account.
How to select a proxy to use
Geonode offers millions of rotating residential IPs from more than 150 countries. We can select a specific proxy URL to use from the Residential Proxy Service page in the Geonode dashboard. For that:
1) Click on the Residential Proxy Service of your choice, under SERVICES on your Geonode Dashboard.
2) Scroll down to the Endpoints section of the service's page. Depending on your selected Session Type under the Proxy Configuration pane within the service page, pick the proxy of your choice.
Geonode provides two types of Residential proxies called the Rotating Proxy and the Sticky Proxy.
Rotating Proxy uses a new IP address for each request made through the proxy.
Sticky Proxy (Static proxy) enables the user to send requests via a single IP address. The default frequency for the sticky ports is 10 minutes.
Both these proxy types provide the following two options to obtain the necessary proxy URLs;
Use Individual URLs
Programmatically load all the URLs to an application using load proxy URL (https://geonode.com/api/ports/residential-sticky).
The user can get the available proxy URLs from the Rotating Proxy Ports section of the Residential Proxy screen and configure the target country.
Country Targeting - This option allows the user to configure a specific country for the proxy to use. Simply select a country and a port and then click on + Add to confirm the selected country.
Note - Once the country is configured in Rotating Proxies, all other ports will automatically use the same country for the proxy connection.
Sticky Proxy (Static Proxy)
The Sticky Proxy Ports section of the Residential proxy screen allows users to get the available sticky proxy URLs and configure the URL Rotating Interval and target Country.
Rotating Interval - The rotating interval allows the user to configure the refresh time of sticky ports. You can get better results by selecting lower expiry times, such as 5 or 10 minutes.
Country Targeting - With this option, users can configure the countries that each port will use for the Geonode proxy service. The sticky proxy allows the user to assign different countries for different ports. Select the required country and the port and then click on + Add.
API Code Generator
The API Code Generator section of your chosen Residential Proxy page provides an efficient way to generate the necessary code blocks to connect to the Geonode proxy in multiple programming languages. The code blocks apply to either Rotating or Sticky proxy types, depending on your selection.
How to check if you are connected to the proxy
Now let's see how to verify if we are connected to the proxy by following the below three steps.
Step 1 - Use an online tool to determine the current IP address (https://ipinfo.io)
Step 2 - Connect to the Proxy (The following section demonstrates how to connect to the proxy using Windows 10)
Navigate to Settings -> Network & Internet -> Proxy
Toggle the "Use a proxy server" option in the "Manual proxy setup" section to "On" and provide any available proxy URL and port in Geonode.
Step 3 - Open a browser and navigate back to an online tool to determine the current IP address (https://ipinfo.io). Then the browser will prompt a popup requesting the username and password. Enter the Geonode username and API Key as username and password, respectively.
If you are successfully connected to the proxy, you will see a different IP address than what was displayed in the first step.
Note - Here, you can directly authenticate without entering the username and password (API Key) by using the previously mentioned IP whitelisting feature. The IP whitelisting method is the ideal choice to route traffic through the proxy at a device level.
How to make an initial request to prove the proxy is working
The user can make a simple request through the proxy server using a command-line utility or a simple script. The following section demonstrates how to make a request in Linux, Windows as well as using C#.
Linux (Bash - curl)
Here, we will be using the curl utility to make the request. Open the bash terminal and type the following commands.
This will make the request using the specified Geonode proxy, and if it is successful, it will provide the user with the output indicating a proxy IP address.
Windows (PowerShell - Invoke-WebRequest)
For Windows, we can use the inbuilt Invoke-WebRequest command in PowerShell to make a web request. Open the PowerShell terminal and enter the following.
A successful request will inform the user of the IP address used in the request as shown below.
Programed Request (C# - Visual Studio)
Go through the following steps to make a request in C#.
Step 1 - Create a simple console project in Visual Studio. In this instance, we have named our project "Geonode Request."
Step 2 - Modify the Program.cs file to reflect the following code block.
private const string Username = "<Geonode Username>";
private const string Password = "<Geonode API Key>";
private const string GeonodeDns = "http://rotating-residential.geonode.com:222";
private const string UrlToGet = "http://ip-api.com/json";
public static async Task Main()
using var httpClient = new HttpClient(new HttpClientHandler
Proxy = new WebProxy(GeonodeDns),
Credentials = new NetworkCredential(Username, Password)
using var responseMessage = await httpClient.GetAsync(UrlToGet);
var contentString = await responseMessage.Content.ReadAsStringAsync();
Console.WriteLine("Response:" + Environment.NewLine + contentString);
Visual Studio Interface
Step 3 - Run the Project (Press F5 on the keyboard). Then, Visual Studio will build and execute the project. If the request is successful, the user will get an output including the IP address of the Geonode proxy.