# Craigslist Scraper - Listings, Prices & Images (`logiover/craigslist-scraper`) Actor
Scrape Craigslist search results at scale: title, price, location, images, coordinates, post date & attributes. Paste any city/category search URL. No login, no API key.
- **URL**: https://apify.com/logiover/craigslist-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** E-commerce, Business, Marketing
- **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## ποΈ Craigslist Scraper - Listings, Prices & Images
#### Scrape Craigslist search results from any city & category β title, price, location, images, coordinates & post date. No login.
**Paste any Craigslist search URL β for-sale, cars, apartments, jobs, services β and pull every listing with price, location, images, GPS coordinates and post date.**
The fast, no-API-key way to build Craigslist datasets at scale.
---
### π 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
```json
{
"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)
```json
{
"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:
```json
{
"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.
***
**Craigslist Scraper Β· Craigslist Listings Scraper Β· Scrape Craigslist Β· Craigslist Price Scraper Β· Craigslist Cars & Apartments Scraper Β· Craigslist Data Export Β· No-API-key Craigslist data**
βοΈ Collects publicly available Craigslist data only. You are responsible for compliance with Craigslist's Terms and applicable laws, including bulk-access limits.
### π 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.
# Actor input Schema
## `searchUrls` (type: `array`):
Paste one or more Craigslist search-results URLs. Open Craigslist, pick a city + category, apply any filters, then copy the URL. Examples: https://newyork.craigslist.org/search/sss?query=iphone β https://losangeles.craigslist.org/search/cta?query=toyota β https://chicago.craigslist.org/search/apa
## `builder` (type: `object`):
Build a search without a URL. Provide city subdomain (e.g. 'newyork'), category code (e.g. 'sss' for-sale, 'cta' cars, 'apa' apartments), optional query, minPrice, maxPrice and a filters object.
## `maxResults` (type: `integer`):
Maximum number of listings to collect across all searches. 0 = unlimited (paginates as deep as Craigslist allows).
## `includeDetails` (type: `boolean`):
Open each listing's detail page to also collect the full description, attributes and full-size images. Much slower β leave off for fast bulk scraping.
## `proxyConfiguration` (type: `object`):
Craigslist blocks datacenter IPs β US residential proxies are required. Leave the default (Apify Proxy Β· RESIDENTIAL Β· US).
## Actor input object example
```json
{
"searchUrls": [
"https://losangeles.craigslist.org/search/cta?query=toyota"
],
"builder": {
"city": "newyork",
"category": "sss",
"query": "iphone"
},
"maxResults": 1000,
"includeDetails": false,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `title` (type: `string`):
Listing title
## `price` (type: `string`):
Listing price
## `location` (type: `string`):
Neighborhood
## `category` (type: `string`):
Category code
## `postedDate` (type: `string`):
Post date
## `url` (type: `string`):
Listing URL
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"searchUrls": [
"https://newyork.craigslist.org/search/sss?query=iphone"
],
"builder": {
"city": "newyork",
"category": "sss",
"query": "iphone"
},
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("logiover/craigslist-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`πΎ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// π Want to learn more π? Go to β https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"searchUrls": ["https://newyork.craigslist.org/search/sss?query=iphone"],
"builder": {
"city": "newyork",
"category": "sss",
"query": "iphone",
},
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US",
},
}
# Run the Actor and wait for it to finish
run = client.actor("logiover/craigslist-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("πΎ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# π Want to learn more π? Go to β https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"searchUrls": [
"https://newyork.craigslist.org/search/sss?query=iphone"
],
"builder": {
"city": "newyork",
"category": "sss",
"query": "iphone"
},
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}' |
apify call logiover/craigslist-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=logiover/craigslist-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Craigslist Scraper - Listings, Prices & Images",
"description": "Scrape Craigslist search results at scale: title, price, location, images, coordinates, post date & attributes. Paste any city/category search URL. No login, no API key.",
"version": "1.0",
"x-build-id": "aQQnvTIQuc8yc4cqU"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/logiover~craigslist-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-logiover-craigslist-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/logiover~craigslist-scraper/runs": {
"post": {
"operationId": "runs-sync-logiover-craigslist-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/logiover~craigslist-scraper/run-sync": {
"post": {
"operationId": "run-sync-logiover-craigslist-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchUrls": {
"title": "Craigslist search URLs",
"type": "array",
"description": "Paste one or more Craigslist search-results URLs. Open Craigslist, pick a city + category, apply any filters, then copy the URL. Examples: https://newyork.craigslist.org/search/sss?query=iphone β https://losangeles.craigslist.org/search/cta?query=toyota β https://chicago.craigslist.org/search/apa",
"items": {
"type": "string"
}
},
"builder": {
"title": "Search builder (alternative to URLs)",
"type": "object",
"description": "Build a search without a URL. Provide city subdomain (e.g. 'newyork'), category code (e.g. 'sss' for-sale, 'cta' cars, 'apa' apartments), optional query, minPrice, maxPrice and a filters object."
},
"maxResults": {
"title": "Max results",
"minimum": 0,
"type": "integer",
"description": "Maximum number of listings to collect across all searches. 0 = unlimited (paginates as deep as Craigslist allows).",
"default": 1000
},
"includeDetails": {
"title": "Fetch listing details",
"type": "boolean",
"description": "Open each listing's detail page to also collect the full description, attributes and full-size images. Much slower β leave off for fast bulk scraping.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Craigslist blocks datacenter IPs β US residential proxies are required. Leave the default (Apify Proxy Β· RESIDENTIAL Β· US).",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```