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.

API documentation: https://core-proxy-service-w34nvoxnwq-uc.a.run.app/api

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.

API	Authentication	Domain	Port
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>

API	Authentication	Domain	Port
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",
  }

State Based Filtering Data

Here is a list of Countries, states and relevant cities that are supported

60KB

locations.json

Open

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:

1. Open the DNS configuration for your domain.

2. Create a CNAME Record pointing to the domain.

API	Authentication	Domain	Port
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

1. Whatever you enter in the name/host will decide the domain which points to our API IP.

2. 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

3. 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"
}