Scraping Craigslist Listings with Perl

Oct 1, 2023 · 4 min read

This article explains how to scrape Craigslist apartment listings using Perl and the modules LWP::UserAgent and HTML::TreeBuilder. We'll go through each part of the code.

First install the modules if needed:

cpan LWP::UserAgent
cpan HTML::TreeBuilder

Use the modules:

use LWP::UserAgent;
use HTML::TreeBuilder;

LWP::UserAgent handles HTTP requests. HTML::TreeBuilder parses HTML.

Set the URL to scrape:

my $url = '<https://sfbay.craigslist.org/search/apa>';

Make the HTTP request and get the response:

my $ua = LWP::UserAgent->new;
my $response = $ua->get($url);

Parse the HTML into a tree:

my $tree = HTML::TreeBuilder->new;
$tree->parse($response->content);

If you check the source code of Craigslist listings you can see that the listings area code looks something like this…

You can see the code block that generates the listing…

<li class="cl-static-search-result" title="Situated in Sunnyvale!, Recycling Center, 1/BD">
            <a href="https://sfbay.craigslist.org/sby/apa/d/santa-clara-situated-in-sunnyvale/7666802370.html">
                <div class="title">Situated in Sunnyvale!, Recycling Center, 1/BD</div>

                <div class="details">
                    <div class="price">$2,150</div>
                    <div class="location">
                        sunnyvale
                    </div>
                </div>
            </a>
        </li>

its encapsulated in the cl-static-search-result class. We also need to get the title class div and the price and location class divs to get all the data

Get all listing nodes:

my @listings = $tree->look_down('_tag', 'li', sub {
  # must have cl-static-search-result class
  my $class = $_->attr('class');
  return ($class && $class =~ /cl-static-search-result/);
});

Loop through listings and extract info:

for my $listing (@listings) {

  my $title = $listing->look_down('_tag', 'div', sub {
    return $_->attr('class') eq 'title'; 
  })->as_text;

  my $price = $listing->look_down('_tag', 'div', sub { 
    return $_->attr('class') eq 'price'; 
  })->as_text;

  my $location = $listing->look_down('_tag', 'div', sub {
    return $_->attr('class') eq 'location';  
  })->as_text;

  my $link = $listing->look_down('_tag', 'a')->attr('href');

  print "$title $price $location $link\n";

}

The full Perl code:

use LWP::UserAgent;
use HTML::TreeBuilder;

my $url = '<https://sfbay.craigslist.org/search/apa>';

my $ua = LWP::UserAgent->new;
my $response = $ua->get($url);

my $tree = HTML::TreeBuilder->new;
$tree->parse($response->content);

my @listings = $tree->look_down('_tag', 'li', sub {
  my $class = $_->attr('class');
  return ($class && $class =~ /cl-static-search-result/);
});

for my $listing (@listings) {

  my $title = $listing->look_down('_tag', 'div', sub {
    return $_->attr('class') eq 'title'; 
  })->as_text;

  my $price = $listing->look_down('_tag', 'div', sub { 
    return $_->attr('class') eq 'price'; 
  })->as_text;

  my $location = $listing->look_down('_tag', 'div', sub {
    return $_->attr('class') eq 'location';  
  })->as_text;

  my $link = $listing->look_down('_tag', 'a')->attr('href');

  print "$title $price $location $link\n";

}

This walks through scraping Craigslist listings in Perl.

This is great as a learning exercise but it is easy to see that even the proxy server itself is prone to get blocked as it uses a single IP. In this scenario where you may want a proxy that handles thousands of fetches every day using a professional 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.

    The whole thing can be accessed by a simple API like below in any programming language.

    In fact, you don't even have to take the pain of loading Puppeteer as we render Javascript behind the scenes and you can just get the data and parse it any language like Node, Puppeteer or PHP or using any framework like Scrapy or Nutch. In all these cases you can just call the URL with render support like so:

    curl "<http://api.proxiesapi.com/?key=API_KEY&render=true&url=https://example.com>"
    
    

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

    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 "http://api.proxiesapi.com/?key=API_KEY&url=https://example.com"

    <!doctype html>
    <html>
    <head>
        <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" />
    ...

    X

    Don't leave just yet!

    Enter your email below to claim your free API key: