Create a New Sticky Session

Create a new sticky session using proxy credentials to maintain a persistent IP address for stable connections.

Create a new sticky session using proxy credentials. Sticky sessions let you keep the same IP address longer, which is useful for tasks that need a stable connection, like managing social media accounts or web scraping. Knowing how to use sticky sessions can improve your proxy experience by making it more efficient and reliable.

Sticky Ports

Geonode provides specific ports for sticky sessions, ensuring a persistent IP session:

Protocol	Port Range
HTTP/HTTPS	10000 - 10900
SOCKS5	12000 - 12010

Use sticky ports when you need a stable IP for session-based activities.

Request

Make a request using a sticky session by including the session ID in your username string:

curl -X "http://proxy.geonode.io:<port>" \
     --user "<geonode_username>-country-<country_code>-session-<session_id>:<geonode_password>" \
     --url "http://ip-api.com/json" \
     --header "Accept: application/json"

Parameters

The session ID can be any custom string (1-25 alphanumeric characters or underscores). As long as you keep sending requests with the same session ID, you will maintain the same proxy IP.

Response

200 Success

The response contains detailed geolocation information about the IP address assigned to your sticky session.

Response Fields

Field	Type	Description
`status`	string	The status of the request (e.g., "success")
`continent`	string	The continent where the IP is located
`continentCode`	string	The two-letter continent code
`country`	string	The full name of the country
`countryCode`	string	The two-letter country code (ISO 3166-1 alpha-2)
`region`	string	The region code
`regionName`	string	The full name of the region
`city`	string	The name of the city
`district`	string	The district name, if available
`zip`	string	The postal code associated with the IP
`lat`	number	The latitude coordinate
`lon`	number	The longitude coordinate
`timezone`	string	The timezone of the IP location
`offset`	integer	The time offset in seconds from UTC
`currency`	string	The currency code of the country
`isp`	string	The name of the Internet Service Provider
`org`	string	The organization that owns the IP address
`as`	string	The Autonomous System (AS) number
`asname`	string	The name associated with the AS number
`mobile`	boolean	Indicates whether the connection is from a mobile network
`proxy`	boolean	Indicates whether the IP is a known proxy
`hosting`	boolean	Indicates whether the IP is from a hosting provider
`query`	string	The queried IP address

Example Response

{
  "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"
}