Proxy Lists

Basic

You should receive a URL to your proxy list from your Dedicated Account Manager or our Support, and it should look something like this:
https://proxy.oxylabs.io/key/a27c5343ce4c4637a85a9297ddf1cace
Open this URL in your browser (or any other preferred software). You will then be asked to enter your login credentials (HTTP Basic Authentication):
Once you do that, you will have a list of proxies in plain text.
If you have multiple lists and wish to get all IPs assigned to your account, you can use this URL:
https://proxy.oxylabs.io/all
You can also include ?showCountry or ?showCity at the end of your URL to get IPs with their corresponding locations.
127.0.0.1:60000
127.0.0.2:60000
127.0.0.3:60000
127.0.0.4:60000

RESTful

Showing All Available Proxy Lists

With this endpoint, you can retrieve proxy lists that belong to your user:
GET https://api.oxylabs.io/v1/proxies/lists

Code examples

cURL
PHP
Python
C#
curl -u username:password "https://api.oxylabs.io/v1/proxies/lists"
<?php
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://api.oxylabs.io/v1/proxies/lists");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, 'username:password');
​
$result = curl_exec($curl);
?>
import requests
requests.get('https://api.oxylabs.io/v1/proxies/lists', auth=('username', 'password'))
using System;
using System.Net;
​
class Example
{
static void Main()
{
var client = new WebClient();
client.Proxy.Credentials = new NetworkCredential("username", "pass");
Console.WriteLine(client.DownloadString("https://api.oxylabs.io/v1/proxies/lists"));
}
}

Sample output

[
{
"uuid": "123e4567-e89b-12d3-a456-426655440000",
"key": "12345678",
"updated_timestamp": "2016-09-28T13:03:50+0300",
"ips_count": 2000,
"href": "http://api.oxylabs.io/v1/proxies/lists/123e4567-e89b-12d3-a456-426655440000"
}
]

Retrieving a Specific Proxy List

With this endpoint, you can retrieve a specific proxy list:
GET https://api.oxylabs.io/v1/proxies/lists/{uuid}

Request parameter

Parameter
Description
uuid
The uuid of the proxy-list to retrieve

Code examples

cURL
PHP
Python
C#
curl -u username:password "https://api.oxylabs.io/v1/proxies/lists/{uuid}"
<?php
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://api.oxylabs.io/v1/proxies/lists/{uuid}");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, 'username:password');
?>
import requests
requests.get('https://api.oxylabs.io/v1/proxies/lists/{uuid}', auth=('username', 'password'))
using System;
using System.Net;
​
class Example
{
static void Main()
{
var client = new WebClient();
client.Proxy.Credentials = new NetworkCredential("username", "pass");
Console.WriteLine(client.DownloadString("https://api.oxylabs.io/v1/proxies/lists/{uuid}"));
}
}

Sample output

[
{
"ip": "127.0.0.1",
"port": "60000",
"country": "BE",
"city": "Brussels",
"created_at": "2022-04-06 13:03:10"
},
{
"ip": "127.0.0.2",
"port": "60000",
"country": "BE",
"city": "Brussels",
"created_at": "2022-04-06 13:03:10"
}
]