Craigslist Scraper

Apify Actor for scraping Craigslist marketplace listings across any city. Uses CheerioCrawler for fast, efficient HTML parsing without a browser.

Features

• Search any Craigslist city by subdomain (newyork, sfbay, chicago, etc.)
• Filter by category, price range, and sort order
• Two modes: quick search results or full detail scraping
• Extracts JSON-LD structured data when available, falls back to HTML parsing
• Detail mode captures: price, description, images, location coordinates, item attributes, post date, and post ID

Input

Field	Type	Default	Description
searchQueries	string[]	["bicycle"]	Search terms to scrape
city	string	"newyork"	Craigslist city subdomain
category	string	"sss"	Category code (sss=all, cta=cars, ela=electronics, etc.)
maxListings	integer	100	Max listings per query (0=unlimited)
scrapeDetails	boolean	false	Visit each listing for full details
minPrice	integer	-	Minimum price filter
maxPrice	integer	-	Maximum price filter
sortBy	string	""	Sort: newest, price_asc, price_desc, relevant
proxyConfiguration	object	{}	Proxy settings (optional for Craigslist)

Example Input

{
    "searchQueries": ["bicycle", "laptop"],
    "city": "sfbay",
    "category": "sss",
    "maxListings": 50,
    "scrapeDetails": true,
    "minPrice": 50,
    "maxPrice": 500
}

Output

Search-only mode (scrapeDetails: false)

{
    "title": "Trek Mountain Bike",
    "url": "https://sfbay.craigslist.org/sby/bik/d/trek-mountain-bike/123456.html",
    "imageUrl": "https://images.craigslist.org/...",
    "position": 1,
    "city": "sfbay",
    "searchQuery": "bicycle",
    "scrapedAt": "2026-03-17T12:00:00.000Z"
}

Detail mode (scrapeDetails: true)

{
    "title": "Trek Mountain Bike",
    "url": "https://sfbay.craigslist.org/sby/bik/d/trek-mountain-bike/123456.html",
    "price": 280,
    "currency": "USD",
    "description": "Great condition Trek mountain bike, 21 speed...",
    "images": ["https://images.craigslist.org/..."],
    "imageCount": 5,
    "condition": "excellent",
    "make": "Trek",
    "model": "Marlin 5",
    "attributes": {
        "condition": "excellent",
        "make": "Trek",
        "model": "Marlin 5"
    },
    "addressLocality": "San Jose",
    "addressRegion": "CA",
    "latitude": 37.3382,
    "longitude": -121.8863,
    "postedDate": "2026-03-15T10:30:00-0700",
    "postId": "7654321",
    "searchQuery": "bicycle",
    "scrapedAt": "2026-03-17T12:00:00.000Z"
}

Common City Subdomains

City	Subdomain
New York	newyork
San Francisco Bay Area	sfbay
Los Angeles	losangeles
Chicago	chicago
Seattle	seattle
Boston	boston
Austin	austin
Denver	denver
Portland	portland
Miami	miami
Atlanta	atlanta
Dallas	dallas
Philadelphia	philadelphia
Washington DC	washingtondc

How It Works

1. Builds search URLs for each query using the city subdomain and category
2. Parses search results via JSON-LD ItemList schema (300+ items per page)
3. Falls back to HTML parsing (li.cl-static-search-result) if JSON-LD is unavailable
4. Optionally visits each listing detail page for rich data extraction
5. Detail pages are parsed via JSON-LD Product schema with HTML fallback enrichment

Quick Start

$apify run --purge

Deploy to Apify

apify login
apify push

Related Scrapers

More marketplace scrapers and data tools by lulzasaur:

• AbeBooks Scraper — Rare and used books
• Bonanza Scraper — Online marketplace listings
• Contractor License Verifier — Multi-state license verification
• Goodreads Scraper — Book ratings and reviews
• Grailed Scraper — Luxury fashion resale
• Houzz Scraper — Home improvement professionals
• IMDb Scraper — Movie and TV show data
• Nurse License Verifier — State nursing board verification
• OfferUp Scraper — Local marketplace listings
• Poshmark Scraper — Fashion resale marketplace
• PSA Population Report — Card grading data
• Redfin Scraper — Real estate listings and prices
• Reverb Scraper — Music gear marketplace
• StubHub Scraper — Event ticket prices
• Swappa Scraper — Used electronics marketplace
• TCGPlayer Scraper — Trading card prices
• ThriftBooks Scraper — Used book prices
• Thumbtack Scraper — Local service professionals