Craigslist Listing Scraper

Scrape for-sale listings from Craigslist across 40+ US cities. Extracts title, price, location, images, and geo coordinates from search pages. Optional detail mode adds full description, condition, make/model, and posting date.

Features

• 40+ US cities — New York, Los Angeles, Chicago, Houston, Miami, San Francisco, and more
• 40+ categories — Electronics, Furniture, Cars, Free, Garage Sale, etc.
• Images included — Thumbnails and full image arrays from search page (no detail fetch needed)
• JSON-LD parsing — Structured data extraction, no fragile CSS selectors
• Price filters — Min/max price range
• Image filter — Only listings with photos
• Posted today — Filter for fresh listings
• Detail mode — Optional: full description, condition, make/model, posting body
• Concurrent detail fetching — 5 parallel requests by default (configurable)
• Retry logic — Automatic retry on transient failures
• Geo data — Latitude/longitude for each listing
• No proxy needed — Direct HTTP requests

Input Parameters

Parameter	Type	Default	Description
location	string	New York	Craigslist city (40+ US cities)
query	string	—	Search keywords
category	select	All	Filter by category (40+ options)
minPrice	integer	—	Minimum price
maxPrice	integer	—	Maximum price
hasPic	checkbox	false	Only listings with images
postedToday	checkbox	false	Only today's listings
fetchDetails	checkbox	false	Fetch detail pages for rich data
detailConcurrency	integer	5	Parallel detail requests (1-20)
maxResults	integer	100	Max listings to return (1-1000)

Output Fields

Basic (always available from search page)

Field	Type	Description
title	string	Listing title
price	float	Price in USD
currency	string	Currency code (USD)
city	string	City name
state	string	State abbreviation
zipCode	string	ZIP code
latitude	float	Latitude coordinate
longitude	float	Longitude coordinate
images	list	Image URLs (from search page)
imageCount	integer	Number of images
thumbnailUrl	string	First image URL
url	string	Direct link to listing
postingId	string	Craigslist posting ID

Detail mode (when fetchDetails=true)

Field	Type	Description
description	string	Short description from JSON-LD
bodyText	string	Full posting body text
condition	string	Item condition (e.g. "excellent", "good", "new")
make	string	Make / manufacturer
model	string	Model name / number
size	string	Size / dimensions
postedDate	string	ISO 8601 posting date

Supported Cities

New York, Los Angeles, Chicago, Houston, Phoenix, Philadelphia, San Antonio, San Diego, Dallas, San Jose, Austin, Jacksonville, Denver, Seattle, Boston, Las Vegas, Miami, Atlanta, Minneapolis, Tampa, Portland, Orlando, Pittsburgh, Sacramento, Salt Lake City, Nashville, Charlotte, Detroit, Washington DC, Cincinnati, Cleveland, Columbus, Indianapolis, Kansas City, Milwaukee, Memphis, Baltimore, and more.

Usage Examples

Electronics in NYC

{
  "location": "New York",
  "query": "laptop",
  "category": "electronics",
  "hasPic": true,
  "maxResults": 50
}

Free stuff in LA

{
  "location": "Los Angeles",
  "category": "free",
  "maxResults": 100
}

Cars under $10,000 in Chicago

{
  "location": "Chicago",
  "category": "cars+trucks",
  "maxPrice": 10000,
  "hasPic": true,
  "maxResults": 50
}

Furniture with full details

{
  "location": "San Francisco",
  "category": "furniture",
  "fetchDetails": true,
  "detailConcurrency": 10,
  "maxResults": 20
}

Technical Details

• Data source: JSON-LD structured data embedded in Craigslist pages
• Speed: ~200-300 listings per page, ~2 seconds per page (basic mode)
• Detail mode: +0.5-2s per listing (parallel, configurable concurrency)
• Retry: 2 retries on transient failures, skip on 404
• Pagination: 120 listings per page, offset-based
• Images: Always included from search page JSON-LD (no extra requests)

Resources

• Craigslist
• Apify SDK for Python