Rotating Credentials

Generate multiple credentials for a rotating residential proxy.

Prerequisites

First, retrieve your active rotating proxy from the history endpoint:

GET /proxies/history/?category=residential_rotating&expired=false

You will need the following fields from the response:

• connection_login
• connection_password
• connection_host
• connection_port

Generate Credentials

POST /proxies/rotating-credentials/

Request Body

{
  "connection_login": "string",
  "connection_password": "string",
  "connection_host": "string",
  "connection_port": 10000,
  "session_type": "random",
  "country_code": "string",
  "region": "string",
  "city": "string",
  "amount": 5
}

Parameters

Parameter	Required	Description
connection_login	Yes	Login from your ordered proxy
connection_password	Yes	Password from your ordered proxy
connection_host	Yes	Host from your ordered proxy
connection_port	Yes	Port from your ordered proxy
session_type	Yes	IP rotation behavior (see below)
country_code	No	Filter by country
region	No	Filter by region
city	No	Filter by city
amount	No	Number of credentials to generate

Session Types

Type	Description
random	IP changes on every request
short_session	Same IP for a short period (~1 min)
long_session	Same IP for a longer period (~4 hours)

Response

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

Each credential string follows the format:

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

tip

You can retrieve the list of supported country_code, region, and city values from the rotating countries reference available in your dashboard.