Documentation Index
Fetch the complete documentation index at: https://docs.pingnetwork.io/llms.txt
Use this file to discover all available pages before exploring further.
By default, each request to our proxy server generates a new IP address. However, you can use session parameters to maintain the same IP address for multiple requests. This feature is useful for tasks that require a stable connection, such as web resources with session-based authentication.
Session Parameters
We offer the session parameter to ensure you keep the same IP for all following requests.
Thesessionparameter
- A unique alphanumeric string, 6 to 15 characters long.
- Optimized for the highest overall success rate.
- May change IP address in favor of stability.
- Works with the
lifetime parameter.
When specifying any geo targeting parameters, the first request will use the specified parameters, and all subsequent requests will use the same IP address. If you change the targeting while maintaining the same session, the IP address will remain the same.
Thelifetimeparameter
- Specifies the duration for the
session in minutes.
- Maximum value is 120 minutes.
- After the specified time, the IP address will change.
- If not specified, the session will last for 40 minutes by default.
If you specify a higher lifetime value than the maximum allowed, the request will return a 412 error code.
Examples
Below are examples of using Sticky sessions in different programming languages: CURL, Python, and JavaScript.
# Using session parameter
curl -x USERNAME-session-abc123:[email protected]:7776 https://ipecho.net/plain
# Using session with lifetime (60 minutes)
curl -x USERNAME-session-abc123-lifetime-60:[email protected]:7776 https://ipecho.net/plain
# Session with geo targeting
curl -x USERNAME-cc-US-session-abc123:[email protected]:7776 https://ipecho.net/plain
import requests
# Using session parameter
proxies = {
'http': 'http://USERNAME-session-abc123:[email protected]:7776',
'https': 'https://USERNAME-session-abc123:[email protected]:7777'
}
# Make multiple requests with the same IP
for i in range(3):
response = requests.get('https://ipecho.net/plain', proxies=proxies)
print(f"Request {i+1}: {response.text.strip()}")
# Using session with lifetime
proxies_with_lifetime = {
'http': 'http://USERNAME-session-xyz789-lifetime-30:[email protected]:7776',
'https': 'https://USERNAME-session-xyz789-lifetime-30:[email protected]:7777'
}
response = requests.get('https://ipecho.net/plain', proxies=proxies_with_lifetime)
print(f"Session with 30min lifetime: {response.text.strip()}")
const axios = require('axios');
const HttpsProxyAgent = require('https-proxy-agent');
// Using session parameter
const sessionProxyUrl = 'http://USERNAME-session-abc123:[email protected]:7776';
const sessionAgent = new HttpsProxyAgent(sessionProxyUrl);
// Make multiple requests with the same IP
async function testSession() {
for (let i = 0; i < 3; i++) {
try {
const response = await axios.get('https://ipecho.net/plain', {
httpsAgent: sessionAgent
});
console.log(`Request ${i+1}: ${response.data.trim()}`);
} catch (error) {
console.error(`Request ${i+1} failed:`, error.message);
}
}
}
// Using session with lifetime
const lifetimeProxyUrl = 'http://USERNAME-session-xyz789-lifetime-45:[email protected]:7776';
const lifetimeAgent = new HttpsProxyAgent(lifetimeProxyUrl);
async function testSessionWithLifetime() {
try {
const response = await axios.get('https://ipecho.net/plain', {
httpsAgent: lifetimeAgent
});
console.log(`Session with 45min lifetime: ${response.data.trim()}`);
} catch (error) {
console.error('Session request failed:', error.message);
}
}
testSession();
testSessionWithLifetime();
