Oxylab

This page will guide you on how to generate sticky and rotating proxies, Supported countries, other optional features, White labeling and FAQs regarding Oxylab APIs.

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

How to generate sticky proxies:

const string = (length) => {
  let result = '';
  const characters = 'abcdefghijklmnopqrstuvwxyz1234567890';
  const charactersLength = characters.length;
  for (let i = 0; i < length; i++) {
    result += characters.charAt(Math.floor(Math.random() * charactersLength));
  }
  return result;
};

function proxyGenerationSticky(amount, country, username, password) {
  proxy = [];
  for (var i = 0; i < parseInt(amount); i++) {
    proxy.push(
      `oxy.x.proxiess.com:7777:${username}:${password}-cc-${country.toLowerCase()}-sessid-${string(8,
      )}-sesstime-30\n`,
    );
  }
  return proxy.join('');
}

General Proxy format of Oxylab Sticky:

<Domain>:<Port>:<username>:<password>-cc-<country code>-sessid-<session id>-sesstime-30

Follow the below table for generate HTTP/HTTPS and SOCKS5.

API	Authentication	Domain	Port
Oxylabs	HTTP/HTTPS	oxy.x.proxiess.com	7777
Oxylabs EU	HTTP/HTTPS	oxyeu.x.proxiess.com	7778
Oxylabs Asia	HTTP/HTTPS	oxyasia.x.proxiess.com	7779
Oxylabs	SOCKS5	socksoxy.x.proxiess.com	7780
Oxylabs EU	SOCKS5	socksoxyeu.x.proxiess.com	7781
Oxylabs Asia	SOCKS5	socksoxyasia.x.proxiess.com	7782

How to generate rotating proxies:

function proxyGenerationRotating(amount, country, username, password) {
  proxy = [];
  for (var i = 0; i < parseInt(amount); i++) {
    proxy.push(
      `oxy.x.proxiess.com:7777:${username}:${password}-cc-${country.toLowerCase()}\n`,
    );
  }
  return proxy.join('');
}

General Proxy format of Oxylab Rotating:

<Domain>:<Port>:<username>:<password>-cc-<country code>

Follow the below table for generate HTTP/HTTPS and SOCKS5.

API	Authentication	Domain	Port
Oxylabs	HTTP/HTTPS	oxy.x.proxiess.com	7777
Oxylabs EU	HTTP/HTTPS	oxyeu.x.proxiess.com	7778
Oxylabs Asia	HTTP/HTTPS	oxyasia.x.proxiess.com	7779
Oxylabs	SOCKS5	socksoxy.x.proxiess.com	7780
Oxylabs EU	SOCKS5	socksoxyeu.x.proxiess.com	7781
Oxylabs Asia	SOCKS5	socksoxyasia.x.proxiess.com	7782

    US: "USA",
    CA: "Canada",
    GB: "GB",
    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

Selecting State:

Select StateOxylabs Documentation

Selecting City:

Select CityOxylabs Documentation

Session Control:

Session ControlOxylabs Documentation

Country Specific Nodes:

Country Specific Entry NodesOxylabs Documentation

White labeling

Use this method to brand your proxies with your own domain/comapny name

To brand the proxies under your domain follow these steps:

1. Open the DNS configuration for your domain.

2. Create a C Name Record pointing to the domain.

3. Whatever you enter in 'host' will decide the domain which points to our API IP.

4. Thus if your domain is API.com and you enter the host premium pointing to the oxylabs domain, your proxies will be formatted premium.yourdomain.com:port:user:pass

5. An example on Godaddy is linked below:

API	Authentication	Record Type	Domain	Port
Oxylabs	HTTP/HTTPS	CNAME	oxy.x.proxiess.com	7777
Oxylabs EU	HTTP/HTTPS	CNAME	oxyeu.x.proxiess.com	7778
Oxylabs Asia	HTTP/HTTPS	CNAME	oxyasia.x.proxiess.com	7779
Oxylabs	SOCKS5	CNAME	socksoxy.x.proxiess.com	7780
Oxylabs EU	SOCKS5	CNAME	socksoxyeu.x.proxiess.com	7781
Oxylabs Asia	SOCKS5	CNAME	socksoxyasia.x.proxiess.com	7782

FAQ

What is Authorization?

This is a header value you provide with every request. We are using 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":1634146275996} 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"
} 

# Sample curl request
curl --location --request POST 'https://elite.proxiesapi.xyz/proxy_api/v1/elite/users/update' \
         --data-raw '{
							"user_id": 3194569,
					    "password": "3eqwd",
					    "traffic_limit": 3
     }' -H "Authorization: Bearer <your api token>" -H "Content-Type: application/json"

GET Request:

{
	"Authorization": "Bearer <your api token>",
}

ava# Sample curl request
curl --location --request GET 'https://elite.proxiesapi.xyz/proxy_api/v1/elite/users/2392122?type=lifetime' \
         -H "Authorization: Bearer <your api token>"