Craigslist Scraper - Listings, Prices & Images

---

📌 Overview

The Craigslist Scraper turns any Craigslist search-results URL into a clean, structured dataset. Point it at a city + category (with any filters or search query you like) and it paginates the results to collect hundreds to thousands of listings, each with title, price, neighborhood, GPS coordinates, image gallery, post date and a direct listing link.

It needs no login, no cookies and no API key — it reads only public data through US residential proxies, so there's zero account risk. With no headless browser it's fast and low-cost, even for huge searches.

✅ Paste multiple search URLs (different cities, categories or queries) and raise maxResults to assemble a market-wide Craigslist dataset in a single run.

---

✨ Features

	Feature	Description
📦	Thousands per search	Deep pagination walks the results, not just the first page.
💲	Price & location	Numeric + formatted price, neighborhood and GPS coordinates.
🖼️	Full image galleries	Every listing photo as a ready-to-use image URL.
🗓️	Post dates	Exact ISO timestamp for each listing.
🔗	Real listing links	Direct, working URL to every Craigslist post.
🌎	Any city & category	For-sale, cars, housing, jobs, services, gigs — any CL search URL.
📝	Optional details	Toggle on to also pull description, attributes & full-size images.
🛡️	Login-free & safe	Public access over US residential proxies — no account, no ban risk.
📤	Any format	Export to JSON, CSV, Excel, HTML or pull via API & webhooks.

---

🎯 Who it's for

• Resellers & flippers — track prices and spot deals across cities and categories.
• Market & price research — analyze supply, pricing and demand for any product.
• Real-estate & auto analysts — pull apartment or vehicle listings at scale.
• Lead generation — find sellers, services and gigs in your target market.
• Data science — build labelled marketplace datasets for pricing & trend models.

---

🧾 Input

Field	Type	Description
searchUrls	array	Craigslist search URLs. Pick a city + category on Craigslist, apply filters, copy the URL.
builder	object	Alternative to URLs: { city, category, query, minPrice, maxPrice, filters }.
maxResults	integer	Max listings to collect across all searches. 0 = unlimited. Default 1000.
includeDetails	boolean	Also open each listing's detail page for description, attributes & full images. Slower. Default false.
proxyConfiguration	object	US residential proxy (required by Craigslist). Pre-configured for you.

Example input

{
  "searchUrls": [
    "https://newyork.craigslist.org/search/sss?query=iphone",
    "https://losangeles.craigslist.org/search/cta?query=toyota&max_price=15000"
  ],
  "maxResults": 2000,
  "includeDetails": false
}

Builder example (no URL needed)

{
  "builder": { "city": "chicago", "category": "apa", "query": "loft", "maxPrice": 2500 },
  "maxResults": 500
}

Common category codes: sss for-sale (all) · cta cars & trucks · apa apartments/housing · jjj jobs · bbb services · ggg gigs · mob cell phones · ele electronics · fua furniture.

---

📦 Output

Each listing is saved as one structured record:

{
  "id": "35724329",
  "title": "iPhone 17 pro Max (Never used) 512gb Unlocked",
  "price": "$1,360",
  "priceValue": 1360,
  "category": "sss",
  "location": "bronx",
  "latitude": 40.8737,
  "longitude": -73.8712,
  "postedDate": "2026-06-04T11:51:55.000Z",
  "slug": "bronx-iphone-17-pro-max-never-used",
  "images": [
    "https://images.craigslist.org/00M0M_4RlzwaQw03v_0t20CI_600x450.jpg",
    "https://images.craigslist.org/00H0H_kF1asOcIYBa_0t20CI_600x450.jpg"
  ],
  "imageCount": 8,
  "url": "https://newyork.craigslist.org/brx/mob/d/bronx-iphone-17-pro-max-never-used/7938688572.html",
  "source": "newyork.craigslist.org",
  "scrapedAt": "2026-06-04T13:14:45.288Z"
}

With includeDetails: true, each record also gains description, attributes, detailLatitude, detailLongitude and fullImages.

📖 Output field reference

Field	Description
id	Craigslist listing identifier
title	Listing title
price / priceValue	Formatted price string and numeric value
location	Neighborhood / sub-area
latitude / longitude	Approximate GPS coordinates
postedDate	When the listing was posted (ISO 8601)
images / imageCount	Photo gallery URLs and count
url	Direct link to the Craigslist listing
category / source	Category code and source city domain
description / attributes	Full text & key-value details (includeDetails)

---

⚙️ How it works

1. You provide one or more Craigslist search URLs (or a builder).
2. The actor resolves each search and paginates through the results.
3. Every listing is parsed into a clean record with price, location, images & date.
4. Optionally, each detail page is opened for description & attributes.
5. Results stream to your dataset, de-duplicated, ready to export.

No login, no cookies, no API keys — and no Craigslist account is ever used or risked.

---

❓ FAQ

Is there a Craigslist API, and do I need a key?

Craigslist has no public API for scraping listings. This actor is a no-API-key Craigslist alternative — it reads public search results over US residential proxies, so you get listing data with no developer key, no login and no cookies.

Does this Craigslist scraper need a login?

No. It collects only public Craigslist data, so no Craigslist account is ever used or put at risk.

How many Craigslist listings can I scrape per search?

Hundreds to thousands — it paginates the results. Control depth with maxResults, and split a market across several search URLs for maximum coverage.

Which cities and categories can I scrape?

Any Craigslist city subdomain and any category — for-sale, cars & trucks, apartments, jobs, services, gigs and more. Paste the search URL from your browser, or use the builder with a city + category code.

Can I export Craigslist data to CSV or Excel?

Yes — results stream to a dataset you can download as CSV, JSON, Excel or HTML, or pull live via the Apify API and webhooks.

Why are residential proxies required?

Craigslist blocks datacenter IPs. The actor defaults to Apify Proxy's US RESIDENTIAL group, which works reliably — just leave the default.

Can I get full descriptions and attributes?

Yes — turn on includeDetails to open each listing page and capture the full description, attributes and full-size images. It's slower, so leave it off for fast bulk scraping.

---

🔗 Works great with

• 🛒 eCommerce & marketplace scrapers — compare prices across platforms.
• 📧 Email & contact extractors — enrich sellers with contact details.

---

📝 Changelog

2026-06-05

• 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results).
• ⚡ Stability & performance hardening; fresh rebuild.

2026-06-04

• Verified live & refreshed build — reliability/maintenance pass.