Geonode

https://docs.geonode.com/
Admin
Geonode is a proxy service platform offering geo-targeted, rotating residential proxies with sticky...
Tokens:44,116
Snippets:927
Trust Score:10
Update:4 months ago
Show doc for...
Tokens:
Raw
### 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:<port>" \
     --user "<geonode_username>-session-<session_id>-lifetime-<lifetime>:<geonode_password>" \
     --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:<port>" \
     --user "<geonode_username>-country-<country_code>-state-<state_name>:<geonode_password>" \
     --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 <proxy_host>:<port> \
    -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"
}
```

--------------------------------

### Initialize Browser

Source: https://docs.geonode.com/docs/guides/automation-frameworks/selenium

Initializes the Chrome WebDriver with the configured proxy and browser options.

```python
browser = webdriver.Chrome(seleniumwire_options=proxy_options, options=chrome_options)
```
Tokens:
Raw