### Enter Proxy Details Source: https://docs.geonode.com/docs/guides/desktop-OS/windows Steps to enter proxy details in Windows. ```text 1. A configuration window will open: 2. Enter the **Proxy IP** and **Port** you copied from your Geonode Dashboard. 3. Click **Save** to apply the settings. ``` -------------------------------- ### Open Proxy Settings Source: https://docs.geonode.com/docs/guides/desktop-OS/windows Steps to open the proxy settings on Windows. ```text 1. Click the **Windows Search Bar** and type: "Change proxy settings" 2. In the settings window, scroll to **Manual Proxy Setup**. ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/sticky-session/get-proxy-session/get This is an example of a successful response when a proxy session is created. ```json { "status": "success", "continent": "Africa", "continentCode": "AF", "country": "Algeria", "countryCode": "DZ", "region": "05", "regionName": "Batna", "city": "Batna City", "district": "", "zip": "05000", "lat": 35.5064, "lon": 6.0707, "timezone": "Africa/Algiers", "offset": 3600, "currency": "DZD", "isp": "4 djaweb de AS fawri", "org": "", "as": "AS36947 Telecom Algeria", "asname": "ALGTEL-AS", "mobile": false, "proxy": false, "hosting": false, "query": "192.168.1.1" } ``` -------------------------------- ### Request Source: https://docs.geonode.com/docs/api-reference/sticky-session/get-proxy-session/get This example shows how to make a GET request to create a sticky session with a specified lifetime and session ID. ```curl curl --request GET \ -x "http://proxy.geonode.io:" \ --user "-session--lifetime-:" \ --url "http://ip-api.com/json" ``` -------------------------------- ### Sticky Sessions SOCKS5 Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/unlimited-residential-proxies Example of enabling sticky sessions for a SOCKS5 connection. ```bash curl --proxy socks5://USERNAME-session-test123:PASSWORD@residential-unlimited-us-01-proxy.geonode.io:13003 https://ipinfo.io ``` -------------------------------- ### Sticky Sessions HTTP Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/unlimited-residential-proxies Example of enabling sticky sessions for an HTTP connection. ```bash curl -x http://USERNAME-session-test123:PASSWORD@residential-unlimited-us-01-proxy.geonode.io:13003 https://ipinfo.io ``` -------------------------------- ### HTTP Basic Connection Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/unlimited-residential-proxies Example of a basic HTTP connection using curl. ```bash curl -x http://USERNAME:PASSWORD@residential-unlimited-us-01-proxy.geonode.io:13003 https://ipinfo.io ``` -------------------------------- ### SOCKS5 Basic Connection Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/unlimited-residential-proxies Example of a basic SOCKS5 connection using curl. ```bash curl --proxy socks5://USERNAME:PASSWORD@residential-unlimited-us-01-proxy.geonode.io:13003 https://ipinfo.io ``` -------------------------------- ### Proxy Format Examples Source: https://docs.geonode.com/docs/guides/browsers/geelark Examples of how to format proxy credentials for Geonode within GeeLark. ```plaintext proxy.geonode.io:9000:geonode_username:password ``` ```plaintext username:password@host:port ``` ```plaintext http://username:password@proxy.geonode.io:9000 ``` -------------------------------- ### Install Required Libraries Source: https://docs.geonode.com/docs/guides/automation-frameworks/selenium Installs the necessary Python libraries: selenium, python-dotenv, and selenium-wire. ```bash pip install selenium python-dotenv selenium-wire ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/geo-targeting/get-city/get An example of a successful JSON response for a city-targeted request. ```json { "status": "success", "continent": "North America", "continentCode": "NA", "country": "United States", "countryCode": "US", "region": "AL", "regionName": "Alabama", "city": "Decatur", "district": "", "zip": 35601, "query": "68.191.141.86" } ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/geo-targeting/get-state/get This is an example of a successful response when performing state-level geo-targeting. ```json { "status": "success", "continent": "North America", "continentCode": "NA", "country": "Canada", "countryCode": "CA", "region": "QC", "regionName": "Quebec", "city": "Granby", "district": "", "zip": "J2H", "query": "192.168.1.1" } ``` -------------------------------- ### Request Source: https://docs.geonode.com/docs/api-reference/geo-targeting/get-state/get This example shows how to make a GET request to perform state-level geo-targeting. ```curl curl --request GET \ -x "http://proxy.geonode.io:" \ --user "-country--state-:" \ --url "http://ip-api.com/json" ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/sticky-session/get-bandwidth-limited/get This is an example of a successful response when creating a bandwidth-limited proxy session. ```json { "status": "success", "country": "Algeria", "countryCode": "DZ", "region": "22", "regionName": "Sidi Bel Abbès", "city": "Sidi Bel Abbes", "zip": "22000", "lat": 34.8934, "lon": -0.6526, "timezone": "Africa/Algiers", "isp": "4 djaweb de AS fawri", "org": "", "as": "AS36947 Telecom Algeria", "query": "197.203.245.147" } ``` -------------------------------- ### Endpoint Format Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/unlimited-residential-proxies This is an example of the endpoint format for tools that accept a single string. ```text residential-unlimited-us-01-proxy.geonode.io:13003:USERNAME:PASSWORD ``` -------------------------------- ### Install Python requests package Source: https://docs.geonode.com/docs/guides/general-proxy-usage/api-code-generator Example command to install the Python 'requests' package if your generated snippet uses it. ```bash pip install requests ``` -------------------------------- ### Targeting a Specific ASN Source: https://docs.geonode.com/docs/guides/proxy-service-guide/asn-isp-targeting Example of how to target a specific ISP by including the country code and ASN in a request. ```text country-us-asn-7018 ``` -------------------------------- ### Pre-authentication Credentials Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/endpoint-formats An example where credentials are placed before the host for compatibility. ```text user:pass@proxy.geonode.io:9000 ``` -------------------------------- ### ISP/ASN-Level Targeting Example Source: https://docs.geonode.com/docs/api-reference/geo-targeting/geo-targeting-options Example of how to append ISP/ASN-level targeting to your username. ```text username-type-residential-country-US-asn-12345 ``` -------------------------------- ### Hostname, Port, Username, and Password Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/endpoint-formats An example including authentication credentials for secure access. ```text proxy.geonode.io:9000:user:pass ``` -------------------------------- ### State-Level Targeting Example Source: https://docs.geonode.com/docs/api-reference/geo-targeting/geo-targeting-options Example of how to append state-level targeting to your username. ```text username-country-US-state-california ``` -------------------------------- ### City-Level Targeting Example Source: https://docs.geonode.com/docs/api-reference/geo-targeting/geo-targeting-options Example of how to append city-level targeting to your username. ```text username-country-US-city-newyork ``` -------------------------------- ### Install Required Libraries Source: https://docs.geonode.com/docs/guides/proxy-speed-and-perfomance/success-latency Installs the necessary Python libraries for running latency tests and visualizing results. ```bash pip install requests matplotlib numpy ``` -------------------------------- ### Set Up a Virtual Environment Source: https://docs.geonode.com/docs/guides/automation-frameworks/selenium Commands to install virtualenv, create a virtual environment, and activate it. ```bash # Install virtualenv if not already installed pip install virtualenv # Create a virtual environment python -m venv .venv # Activate the virtual environment ## On Windows .venv\Scripts\activate ## On macOS/Linux source .venv/bin/activate ``` -------------------------------- ### Setting up environment variables Source: https://docs.geonode.com/docs/guides/automation-frameworks/selenium Example .env file content for configuring Geonode proxy credentials and host. ```dotenv GEONODE_USERNAME=your_geonode_username GEONODE_PASSWORD=your_geonode_password GEONODE_HOST=proxy.geonode.io GEONODE_PORT=9000 GEONODE_DNS=your_geonode_dns ``` -------------------------------- ### Example Proxy Endpoint Configuration Source: https://docs.geonode.com/docs/guides/proxy-api-management/sticky-session/new-sticky-session An example of a configured proxy endpoint for sticky sessions, showing the IP, port, username, and password components. ```text 92.204.164.15:10000:geonode_demouser-type-residential-lifetime-3-RAOnwR ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/sticky-session/get-create/get Example of a successful response containing detailed geolocation information about the IP address assigned to your sticky session. ```json { "status": "success", "continent": "Africa", "continentCode": "AF", "country": "Algeria", "countryCode": "DZ", "region": "05", "regionName": "Batna", "city": "Batna City", "district": "", "zip": "05000", "lat": 35.5064, "lon": 6.0707, "timezone": "Africa/Algiers", "offset": 3600, "currency": "DZD", "isp": "4 djaweb de AS fawri", "org": "", "as": "AS36947 Telecom Algeria", "asname": "ALGTEL-AS", "mobile": false, "proxy": false, "hosting": false, "query": "XXX.XXX.XXX.XXX" } ``` -------------------------------- ### Example Request Body Source: https://docs.geonode.com/docs/api-reference/sticky-session/release-sticky-session/put-release-by-session-id-and-port This is an example of the JSON request body used to specify session details for release. ```json { "data": [ { "sessionId": "random0001", "port": 10000 } ] } ``` -------------------------------- ### Hostname and Port Example Source: https://docs.geonode.com/docs/guides/proxy-service-guide/endpoint-formats A basic example of a hostname and port for a proxy endpoint. ```text proxy.geonode.io:9000 ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/sticky-session/get-list-active/get An example of a successful response when listing active sessions. ```json { "sessions": [ { "id": "a7f7c7a3-aaaa-4908-b7bd-71091daadaa6", "userSessionId": "vzzzzd", "userId": "geonode_userid", "port": "10000", "domain": "ip-api.com", "country": "dz", "rotatingIntervalInSeconds": 179.32, "durationInSeconds": 2.785 } ], "count": 1, "total": 1, "page": 1, "pageSize": 250 } ``` -------------------------------- ### Python Example Using Requests Library Source: https://docs.geonode.com/docs/guides/proxy-api-management/rotating-proxies Demonstrates how to make API calls using rotating proxies with the Python requests library. ```python import requests username = "geonode_demouser-type-residential" password = "demopass" GEONODE_DNS = "92.204.164.15:9000" url = "http://ip-api.com" proxy = { "http": f"http://{username}:{password}@{GEONODE_DNS}" } response = requests.get(url, proxies=proxy) print("Response:\n", response.text) ``` -------------------------------- ### Create a Sticky Session via API using cURL Source: https://docs.geonode.com/docs/guides/proxy-api-management/sticky-session/new-sticky-session Example of using cURL to create a sticky session by making a request to the configured proxy endpoint. ```bash curl -x 92.204.164.15:10000 \ --user "geonode_demouser-type-residential-lifetime-3-RAOnwR:demopass" \ --url "http://ip-api.com/json" \ --header "Accept: application/json" ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/available-geo-locations/get This is an example of a successful response structure for retrieving geo-locations. ```json [ { "code": "AF", "name": "Afghanistan", "cities": { "prefix": "-city-", "options": [ { "code": "kabul", "name": "Kabul" } ] }, "states": { "prefix": "-state-", "options": [ { "code": "kabul", "name": "Kabul" } ] }, "asns": { "prefix": "-asn-", "options": [ { "code": "131284", "name": "AS131284 Etisalat Afghan" } ] } } ] ``` -------------------------------- ### Example: Fallback Enabled (-strict-off) Source: https://docs.geonode.com/docs/api-reference/geo-targeting/perform-strict-matching Example cURL command to allow fallback to a different location in the same country when the requested location is unavailable. ```bash curl -x : \ -U "geonode_username-type-residential-country-fr-asn-3215-strict-off:your_password" \ --url "http://ip-api.com" ``` -------------------------------- ### Country-Level Targeting Example Source: https://docs.geonode.com/docs/api-reference/geo-targeting/geo-targeting-options Example of how to append country targeting to your username. ```text username-country-US ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/geo-targeting/get-isp/get Example JSON response for a successful ISP/ASN targeting request. ```json { "status": "success", "continent": "Europe", "continentCode": "EU", "country": "Russia", "countryCode": "RU", "region": "VGG", "regionName": "Volgograd Oblast", "city": "Volgograd", "district": "", "zip": "", "lat": 48.5044, "lon": 44.5838, "timezone": "Europe/Volgograd", "offset": 14400, "currency": "RUB", "isp": "JSC ER-Telecom Holding Volgograd branch", "org": "JSC Columbia-Telecom", "as": "AS50543 JSC ER-Telecom Holding", "asname": "SARATOV-AS", "mobile": false, "proxy": false, "hosting": false, "query": "83.167.79.185" } ``` -------------------------------- ### Example Response Source: https://docs.geonode.com/docs/api-reference/exclude-targeting/exclude-city/get Example JSON response for a successful city exclusion request. ```json { "status": "success", "country": "United States", "countryCode": "US", "region": "NC", "regionName": "North Carolina", "city": "Charlotte", "zip": "28202", "lat": 35.2327, "lon": -80.8461, "timezone": "America/New_York", "isp": "FiberPower LLC", "org": "FiberPower LLC", "as": "AS214483 FiberPower LLC", "query": "38.13.166.129" } ``` -------------------------------- ### Example Request Source: https://docs.geonode.com/docs/api-reference/ip-filter/get This example shows how to filter proxy IPs by type using the `-type-` parameter in the username. ```bash curl -x "http://proxy.geonode.io:" --user "-type--country-:" --url "http://ip-api.com/json" --header "Accept: application/json" ```