Building a Simple Proxy Rotator with Perl and Mojo

Oct 2, 2023 · 4 min read

In the beginning stages of a web crawling project or when you have to scale it to only a few hundred requests, you might want a simple proxy rotator that uses the free proxy pools available on the internet to populate itself now and then.

We can use a website like to fetch public proxies every few minutes and use them in our Perl projects.

This is what the site looks like:

And if you check the HTML using the inspect tool, you will see the full content is encapsulated in a table with the id proxylisttable

The IP and port are the first and second elements in each row.

We can use the following code to select the table and its rows to iterate on and further pull out the first and second elements of the elements.

Mojo::UserAgent makes it easy to fetch and parse web pages in Perl.

First, install Mojo::UserAgent:

cpan Mojo::UserAgent

Then we can fetch the proxy list page:

use Mojo::UserAgent;

my $ua = Mojo::UserAgent->new;

my $url = '<>';

my $tx = $ua->get($url);

my $response = $tx->res->dom;

This will fetch the HTML from and parse it into a Mojo::DOM object we can query.

The proxy IP and port are in the first and second columns of each row in the table with id "proxylisttable".

We can use CSS selectors to extract them:

my @proxies;

for my $row ($response->find('#proxylisttable tr')->each) {

  my ($ip, $port) = $row->find('td')->map('text')->list;

  push @proxies, {
    ip   => $ip,
    port => $port


Now let's wrap this in a function we can call periodically to refresh the proxies:

sub load_proxies {

  my $ua = Mojo::UserAgent->new;

  my $url = '<>';

  my $tx = $ua->get($url);

  my $response = $tx->res->dom;

  my @proxies;

  for my $row ($response->find('#proxylisttable tr')->each) {

    my ($ip, $port) = $row->find('td')->map('text')->list;

    push @proxies, {
      ip   => $ip,
      port => $port


  return @proxies;


To fetch a random proxy:

my @proxies = load_proxies();

my $random_idx = int rand @proxies;

my $random_proxy = $proxies[$random_idx];

print "$random_proxy->{ip}:$random_proxy->{port}\\n";

You can call load_proxies() every few minutes to refresh the list.

For using the proxies, a module like LWP::UserAgent makes it easy:

use LWP::UserAgent;

my $ua = LWP::UserAgent->new;

my @proxies = load_proxies();

my $random_proxy = $proxies[int rand @proxies];

$ua->proxy('http', "http://$random_proxy->{ip}:$random_proxy->{port}");

my $response = $ua->get('<>');

This will make the request through a random proxy from the list.

So in summary:

  • Use Mojo::UserAgent to fetch and parse proxy lists
  • Extract proxies from the table rows
  • Refresh periodically by calling load_proxies()
  • Select a random proxy to use for each request
  • Make proxied requests with LWP::UserAgent
  • This provides a simple but effective Perl proxy rotator for web scraping and crawling projects.

    If you want to use this in production and want to scale to thousands of links, then you will find that many free proxies won't hold up under the speed and reliability requirements. In this scenario, using a rotating proxy service to rotate IPs is almost a must.

    Otherwise, you tend to get IP blocked a lot by automatic location, usage, and bot detection algorithms.

    Our rotating proxy server Proxies API provides a simple API that can solve all IP Blocking problems instantly.

  • With millions of high speed rotating proxies located all over the world • With our automatic IP rotation • With our automatic User-Agent-String rotation (which simulates requests from different, valid web browsers and web browser versions) • With our automatic CAPTCHA solving technology
  • Hundreds of our customers have successfully solved the headache of IP blocks with a simple API.

    A simple API can access the whole thing like below in any programming language.

    curl "<>"

    We have a running offer of 1000 API calls completely free. Register and get your free API Key here.

    Browse by tags:

    Browse by language:

    The easiest way to do Web Scraping

    Get HTML from any page with a simple API call. We handle proxy rotation, browser identities, automatic retries, CAPTCHAs, JavaScript rendering, etc automatically for you

    Try ProxiesAPI for free

    curl ""

    <!doctype html>
        <title>Example Domain</title>
        <meta charset="utf-8" />
        <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />


    Don't leave just yet!

    Enter your email below to claim your free API key: