cURL Request Parameters

Below is a list of parameters followed by examples of request types:

Parameter	Description
USERNAME	Username of proxy user.
res	Indicates query for residential proxy.
res_sc	Prefix indicating the use of state/city configuration.
country	Country code in two-letter format, not case sensitive. For example, nl indicates a proxy in the Netherlands; za for South Africa; it for Italy.
city	City name, should be combined with country code, for example nl_amsterdam.
state	US state, in combination with city name, for example us_alabama_birmingham.
SID	Session ID keeps the same IP for the next queries. Otherwise, a new IP is assigned for each new request. The same IP address can be used until the end user device disconnects or the session is terminated. Note that session ID (SID) does not guarantee the same IP address will be used for future sessions. SID supports any random number up to 9 digits. The lowest SID can be sid-1, and the highest SID can be sid-999999999.
NNID	The Long Session ID feature allows keeping the same IP for longer time frames (sessions) than the standard Session ID (SID) feature. Note that Long Session ID time for RES requests can be maintained for up to 1 hour.
ASN	Add ASN number to request specific network or provider for routing internet traffic. Note - ASN works only with res_sc.
PASSWORD	Proxy user password.
site URL	User's destination site.

A basic query inserting only USERNAME and PASSWORD will be performed from a random residential IP address:

· curl-x USERNAME-res-any:[email protected]:5959 "example.site.com"

Request a specific country/state/city proxy, as in the examples below:

· curl-x USERNAME-res-nl:[email protected]:5959 "example.site.com"

· curl-x USERNAME-res_sc-nl_amsterdam:[email protected]:5959 "example.site.com"

· curl-x USERNAME-res_sc-us_alabama_birmingham:[email protected]:5959 "example.site.com"

Add the SID (session ID) parameter to use the same IP for the next queries. Note that SID must be preceded by a country:

curl-x USERNAME-res-row-sid-947045456:[email protected]:5959" "example.site.com"

Enter an ASN number in your request to choose proxies from a specific carrier or network:

curl-x USERNAME-res_sc-ASNnumber:[email protected]:5959" "example.site.com"

Note: You can use either country or ASN parameter in each request.

You can search for ASN numbers here.

The Long Session ID feature allows keeping the same IP for longer time frames (sessions) than the standard Session ID (SID) feature. Note that Long Session ID time for RES requests can be maintained for up to 1 hour.

In order to use the Long Session ID feature, the following initial request has to be sent –

curl-x USERNAME-resfix-<country>-nnid-0:[email protected]:5959 "example.site.com"

The response for the initial request will include the unique token X-NN-LLS, for example -

< HTTP/1.1 200 OK

< Cache-Control: private

< Content-Type: text/html; charset=utf-8

< Server: Microsoft-IIS/10.0

< X-AspNet-Version: 4.0.30319

< X-Powered-By: ASP.NET

< Date: Wed, 31 Jan 2024 11:11:07 GMT

< Content-Length: 12

< Connection: keep-alive

< X-NN-LLS: c3e2154118da4f6f49d

If you wish to use subsequent requests with the same IP address (the same IP address is used until the end user device disconnects), replace nnid-0 with nnid-"unique token"

For example, using the above response, the subsequent requests would be - curl -x USERNAME-resfix-<country>-nnid-c3e2154118da4f6f49d:[email protected]:5959 "example.site.com"

Important note: The unique token you received is relevant for the initial request sent.

For example, if in the initial request the selected country was UK, then the unique token will cause all subsequent requests to use a UK IP address.