Skip to main content
cURL
Generate dynamic proxy connection details for the selected country or city. The same endpoint supports dynamic residential and mobile products with the corresponding product credentials.

Prepare the generation request

  1. Obtain Crc and the product’s key from your dashboard. Use mainKey for residential proxies; for mobile proxies, use mobileMainKey and set mealType=mobile.
  2. Choose location, quantity, protocol, output format, and session behavior using the parameters below. Preserve each query parameter’s capitalization.
  3. Send the request and check the HTTP status. On success, read the plain-text connection list in the selected format, then verify it in your client.
SessionTime=0 means rotation on each request, and SessionTime=-1 selects manual rotation. The source does not state the unit or complete supported range for positive values. Do not infer a duration from the numeric value alone. The form’s numeric bounds come from the current public interface. Country, city, and gateway line examples are not complete option lists. Use values provided by your current dashboard. For product setup, see dynamic residential proxies or mobile proxies. See response handling when generation fails.

Online debugging

Source: official dynamic generation reference.

Authorizations

Crc
string
query
required

Proxy-account password value; a sensitive credential in the query string.

KeyName
string
query
required

Main key for the selected product; supply it together with Crc.

Query Parameters

Num
integer
required

Number of proxy lines to return.

Example:

1

Country
string

Country code. Leave blank for a random country.

Example:

"US"

State
string

Optional state or province.

City
string

Optional city.

SessionTime
integer
required

0 rotates each request; -1 enables manual switching.

Example:

-1

Server
string
required

Gateway node, such as as, us, or eu.

Example:

"us"

Format
enum<string>
required

Controls the returned proxy credential layout.

Available options:
0,
1,
2
Example:

"0"

Crc
string<password>
required

Password value associated with the proxy account.

Pool
integer
required

Proxy pool number.

Example:

1

KeyName
string<password>
required

Use mainKey for residential or mobileMainKey for mobile traffic.

mealType
string

Use mobile for mobile traffic; leave blank for standard dynamic residential traffic.

GenType
enum<string>

Optional protocol override.

Available options:
http,
socks5

Response

Generated proxy lines

The response is of type string.