Rotating Proxy Credentials

Generate credentials for rotating residential proxies with custom session types and geographic targeting.

Generate Rotating Credentials

Create credential strings for rotating proxies with specific parameters.

Endpoint

POST /proxies/rotating-credentials/

Prerequisites

First, obtain the connection details from your ordered rotating proxy:

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/history/?category=residential_rotating&expired=false' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

You'll need:

• connection_login
• connection_password
• connection_host
• connection_port

Request

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/proxies/rotating-credentials/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "connection_login": "your_login",
    "connection_password": "your_password",
    "connection_host": "proxy.example.com",
    "connection_port": 8080,
    "session_type": "short_session",
    "country_code": "us",
    "region": "california",
    "city": "los angeles",
    "amount": 5
  }'

Request Fields

Field	Type	Required	Description
connection_login	string	Yes	Login from ordered proxy
connection_password	string	Yes	Password from ordered proxy
connection_host	string	Yes	Host from ordered proxy
connection_port	integer	Yes	Port from ordered proxy
session_type	string	Yes	Type of IP rotation (see below)
country_code	string	No	Target country code
region	string	No	Target region
city	string	No	Target city
amount	integer	No	Number of credentials to generate (only for short_session)

Session Types

Type	Description
random	IP changes on every request/refresh
short_session	Same IP maintained for ~1 minute
long_session	Same IP maintained for ~4 hours

Response

{
  "credentials": [
    "login-session_params:password@host:port",
    "login-session_params:password@host:port"
  ]
}

The credentials are in the format:

<connection_login>-<session_params>:<connection_password>@<connection_host>:<connection_port>

Geographic Targeting

For supported countries, regions, and cities, refer to the rotating countries JSON file:

Download rotating_countries.json

Usage Example

import requests

# Generate credentials
credentials_response = requests.post(
    'https://app.cyberyozh.com/api/v1/proxies/rotating-credentials/',
    headers={'X-Api-Key': 'your_api_key'},
    json={
        'connection_login': 'your_login',
        'connection_password': 'your_password',
        'connection_host': 'proxy.example.com',
        'connection_port': 8080,
        'session_type': 'short_session',
        'country_code': 'us',
        'amount': 3
    }
)

creds = credentials_response.json()['credentials']

# Use the first credential
proxy = {
    'http': f'http://{creds[0]}',
    'https': f'http://{creds[0]}'
}

response = requests.get('https://api.ipify.org', proxies=proxy)
print(f"Your IP: {response.text}")

Notes

• The amount parameter only works with short_session type
• Geographic targeting options depend on the proxy provider's coverage
• Credentials are generated dynamically and can be regenerated as needed