Netnut
This page will guide you on how to generate sticky and rotating proxies, Supported countries, other optional features, White labeling and FAQs regarding Netnut APIs.
How to generate sticky proxies:
export const randomNumberString = (length: number) => {
const min = Math.pow(10, length - 1);
const max = Math.pow(10, length) - 1;
return Math.floor(Math.random() * (max - min + 1)) + min;
};
function proxyGenerationSticky(amount, country, username, password) {
proxy = [];
for (var i = 0; i < parseInt(amount); i++) {
proxy.push(
`netnut.x.proxiess.com:6500:${username}:${password}-res-${country.toLowerCase()}-sid-${randomNumberString(8,
)}\n`,
);
}
return proxy.join('');
}Session ( add this under sticky proxy generation )
Session ID (sid-<numer string>) 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. Make sure to enter number greater than 1 and less than or equal to 9 for randomNumberString function. The lowest SID can be sid-1, and the highest SID can be sid-999999999.
General Proxy format for Netnut Sticky:
<Domain>:<Port>:<username>:<password>-res-<country code>-sid-<session id>Follow the below table for generate HTTP/HTTPS and SOCKS5.
Netnut
HTTP/HTTPS
netnut.x.proxiess.com
6500
Netnut EU
HTTP/HTTPS
netnuteu.x.proxiess.com
6501
Netnut Asia
HTTP/HTTPS
netnutasia.x.proxiess.com
6502
Netnut
SOCKS5
socksnetnut.x.proxiess.com
6503
Netnut EU
SOCKS5
socksnetnuteu.x.proxiess.com
6504
Netnut Asia
SOCKS5
socksnetnutasia.x.proxiess.com
6505
How to generate rotating proxies:
function proxyGenerationRotating(amount, country, username, password) {
proxy = [];
for (var i = 0; i < parseInt(amount); i++) {
proxy.push(
`netnut.x.proxiess.com:6500:${username}:${password}-res-${country.toLowerCase()}\n`,
);
}
return proxy.join('');
}General Proxy format of Netnut Rotating:
<Domain>:<Port.:<username>:<password>-res-<country code>Netnut
HTTP/HTTPS
netnut.x.proxiess.com
6500
Netnut EU
HTTP/HTTPS
netnuteu.x.proxiess.com
6501
Netnut Asia
HTTP/HTTPS
netnutasia.x.proxiess.com
6502
Netnut
SOCKS5
socksnetnut.x.proxiess.com
6503
Netnut EU
SOCKS5
socksnetnuteu.x.proxiess.com
6504
Netnut Asia
SOCKS5
socksnetnutasia.x.proxiess.com
6505
City
res_sc-<country code>_<city name> is the key to target a city. The value should be the name of the city.
Additionally, it's essential to specify the country when targeting a specific city, as multiple countries may have cities with the same name.
Example:
netnuteu.x.proxiess.com:6501:<username>:<password>-res_sc-nl_amsterdam-sid-<session id>State
res_sc-<country code>_<state name>_<city name> is the key to target a city. The value should be the name of the city.
Additionally, it's essential to specify the country when targeting a specific city, as multiple countries may have cities with the same name.
Example:
netnut.x.proxiess.com:6500:<username>:<password>-res-us_alabama_birmingham_sid-<session id>Supported countries:
US: "USA",
CA: "Canada",
UK: "UK",
DE: "Germany",
FR: "France",
ES: "Spain",
IT: "Italy",
SE: "Sweden",
GR: "Greece",
PT: "Portugal",
NL: "Netherlands",
BE: "Belgium",
RU: "Russia",
UA: "Ukraine",
PL: "Poland",
IL: "Israel",
TR: "Turkey",
AU: "Australia",
MY: "Malaysia",
TH: "Thailand",
KR: "South Korea",
JP: "Japan",
PH: "Philippines",
SG: "Singapore",
CN: "China",
HK: "Hong Kong",
TW: "Taiwan",
IN: "India",
PK: "Pakistan",
IR: "Iran",
ID: "Indonesia",
AZ: "Azerbaijan",
KZ: "Kazakhstan",
AE: "UAE",
MX: "Mexico",
BR: "Brazil",
AR: "Argentina",
CL: "Chile",
PE: "Peru",
EC: "Ecuador",
CO: "Colombia",
ZA: "South Africa",
EG: "Egypt",
AO: "Angola",
CM: "Cameroon",
CF: "Central African Republic",
TD: "Chad",
BJ: "Benin",
ET: "Ethiopia",
DJ: "Djibouti",
GM: "Gambia",
GH: "Ghana",
CI: "Côte d'Ivoire",
KE: "Kenya",
LR: "Liberia",
MG: "Madagascar",
ML: "Mali",
MR: "Mauritania",
MU: "Mauritius",
MA: "Morocco",
MZ: "Mozambique",
NG: "Nigeria",
SN: "Senegal",
SC: "Seychelles",
ZW: "Zimbabwe",
SS: "South Sudan",
SD: "Sudan",
TG: "Togo",
TN: "Tunisia",
UG: "Uganda",
ZM: "Zambia",
AF: "Afghanistan",
BH: "Bahrain",
BD: "Bangladesh",
AM: "Armenia",
BT: "Bhutan",
MM: "Myanmar",
KH: "Cambodia",
GE: "Georgia",
IQ: "Iraq",
JO: "Jordan",
LB: "Lebanon",
MV: "Maldives",
MN: "Mongolia",
OM: "Oman",
QA: "Qatar",
SA: "Saudi Arabia",
VN: "Vietnam",
TM: "Turkmenistan",
UZ: "Uzbekistan",
YE: "Yemen",
AL: "Albania",
AD: "Andorra",
AT: "Austria",
BA: "Bosnia and Herzegovina",
BG: "Bulgaria",
BY: "Belarus",
HR: "Croatia",
CY: "Cyprus",
CZ: "Czech Republic",
DK: "Denmark",
EE: "Estonia",
FI: "Finland",
HU: "Hungary",
IS: "Iceland",
IE: "Ireland",
LV: "Latvia",
LI: "Liechtenstein",
LT: "Lithuania",
LU: "Luxembourg",
MT: "Malta",
MC: "Monaco",
MD: "Moldova",
ME: "Montenegro",
NO: "Norway",
RO: "Romania",
RS: "Serbia",
SK: "Slovakia",
SI: "Slovenia",
CH: "Switzerland",
MK: "Macedonia",
BS: "Bahamas",
BZ: "Belize",
VG: "British Virgin Islands",
CR: "Costa Rica",
CU: "Cuba",
DM: "Dominica",
HT: "Haiti",
HN: "Honduras",
JM: "Jamaica",
AW: "Aruba",
PA: "Panama",
PR: "Puerto Rico",
TT: "Trinidad and Tobago",
FJ: "Fiji",
NZ: "New Zealand",
BO: "Bolivia",
PY: "Paraguay",
UY: "Uruguay",
VE: "Venezuela",
}Other Optional Features:
Generate proxy list using endpoint
https://help.netnut.io/netnut-documentation/netnut-proxies/residential-proxies/endpoint-generator
White labeling:
Use this method to brand your proxies with your own domain/company name
To brand the proxies under your domain follow these steps:
Open the DNS configuration for your domain.
Create a CNAME Record pointing to the domain.
Netnut
HTTP/HTTPS
netnut.x.proxiess.com
6500
Netnut EU
HTTP/HTTPS
netnuteu.x.proxiess.com
6501
Netnut Asia
HTTP/HTTPS
netnutasia.x.proxiess.com
6502
Netnut
SOCKS5
socksnetnut.x.proxiess.com
6503
Netnut EU
SOCKS5
socksnetnuteu.x.proxiess.com
6504
Netnut Asia
SOCKS5
socksnetnutasia.x.proxiess.com
6505
Whatever you enter in the name/host will decide the domain which points to our API IP.
Thus if your domain is API.com and you enter the host premium or whatever you want to call it pointing to the IPRoyal domain, your proxies will be formatted premium.yourdomain.com:port:user:pass
An example on Godaddy is linked below:
FAQ
What is Authorization?
This is a header value you provide with every request. We are using the Bearer token so send in the header like this: "Authorization: Bearer <your API token>"
Im getting this error:
{"message":"username cannot be null or undefined.","timestamp":1634146255996}how do I fix it?
Make sure you have this "Content-Type": "application/json" header present in your requests.
Headers
Please check on how to send requests with headers in whichever languages you are using.
POST Request:
{
"Authorization": "Bearer <your api token>",
"Content-Type": "application/json"
}
Last updated