# Craigslist Scraper - Listings, Prices, Photos & Contacts (`scrapersdelight/craigslist-scraper`) Actor

Scrape craigslist listings from any city, category and keyword: title, price, location with GPS, posting body, attributes (year, odometer, VIN, beds, baths, salary), every photo, posted/updated dates, and phones or emails written in the posting. Monitor mode returns only new postings.

- **URL**: https://apify.com/scrapersdelight/craigslist-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** E-commerce, Lead generation, Real estate
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.45 / 1,000 craigslist listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Craigslist Scraper do?

**Craigslist Scraper** extracts **craigslist listings** from any of craigslist's 707 city sites — for sale, cars & trucks, housing, jobs, gigs, services, community and events — and turns a city + keyword (or any craigslist link you paste) into clean rows: title, price, place with GPS, the full posting text, every attribute (year, odometer, VIN, beds, baths, salary), all photos, dates, and the phone numbers or emails the poster wrote in the posting. Built for used-car buyers and dealers, rental and real-estate investors, recruiters, lead-gen teams and price researchers.

Craigslist scraper · craigslist API · craigslist listings scraper · craigslist data extractor

- **Any city, any category, any keyword:** type `sfbay`, `newyork`, `toronto`, `london` (or `all-us`, `all-ca`) and a keyword, or paste search and posting links of either craigslist link style.
- **Full posting details by default:** description, attributes, photo gallery, street and postal code, posted / updated / expiry dates, read from each posting page.
- **Up to 10,000 postings per search:** the actor reads craigslist's own search data, so a search returns everything craigslist has for it, up to craigslist's 10,000-per-search ceiling, and reports craigslist's own total.
- **Every craigslist filter:** price, condition, owner/dealer, ZIP + radius, sub-area, has image, posted today, beds/baths/sqft, cats/dogs, make/model, year and odometer ranges — plus any other craigslist parameter.
- **Monitor mode:** schedule it and get only postings listed since the last run, plus optional price-change alerts with the previous price.
- **No login, cookies or API key.** Pay only for delivered postings: no start fee, nothing charged for filtered, already-seen or deleted postings.
- **Export anywhere:** JSON, CSV, Excel, XML; schedules, webhooks, Make, Zapier, n8n, Google Sheets, Slack, the Apify API and MCP.

### What data can you get from craigslist?

<table>
<tr><td>🔗 Posting link + id (`url`, `postId`)</td><td>📝 Title and full description</td><td>💲 Price, price text, currency</td></tr>
<tr><td>🗂️ Category, section, owner/dealer</td><td>🏙️ City site, sub-area, neighborhood</td><td>📍 Latitude / longitude</td></tr>
<tr><td>🏠 Street, city, postal code</td><td>📅 Posted, updated, listed, expires</td><td>🖼️ Every photo (`imageUrls`)</td></tr>
<tr><td>🚗 Year, make/model, odometer, VIN</td><td>🛏️ Bedrooms, bathrooms, sqft, availability</td><td>💼 Job title, company, compensation</td></tr>
<tr><td>☎️ Phone numbers in the posting</td><td>✉️ Emails in the posting</td><td>🧾 Every attribute (`attributes`)</td></tr>
<tr><td>👤 "More ads by this seller" link</td><td>♻️ Repost group key</td><td>🔔 NEW / PRICE_CHANGED + previous price</td></tr>
</table>

On our 100-posting test runs (2026-10-14) a phone number was written in the posting body in 82% of Chicago apartment listings, 62% of Chicago services, 42% of Los Angeles cars and 29% of Los Angeles jobs; 51% of LA car listings carried a VIN.

### How to scrape craigslist with Craigslist Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) — $5 of monthly credit, no card needed.
2. Open [Craigslist Scraper](https://apify.com/scrapersdelight/craigslist-scraper) and click **Try for free**.
3. Type a city into **Cities** (`sfbay`, `newyork`, `chicago`...), a keyword into **Search keywords**, pick a **Category** — or paste craigslist links into **Craigslist URLs**.
4. Set **Max postings** and click **Start**. Rows are saved as they are read.
5. Open the **Storage** tab and **Export** as JSON, CSV or Excel — or schedule the run and turn on **Only new postings**.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `startUrls` | list | craigslist search links (old `sfbay.craigslist.org/search/...` or new `www.craigslist.org/search/area/...`) and posting links. A pasted search keeps its own filters. |
| `searchQueries` | list | One search per keyword. Empty = every posting in the category. |
| `locations` | list | City sites: `sfbay`, `newyork`, `toronto`, `london`, a craigslist link, or `all-us` / `all-ca` / `all-gb` / `all`. Default (nothing given): SF bay area. |
| `category` | select | craigslist section, default `sss` (all for sale); 139 options from craigslist's own menu. |
| `categoryCode` | text | Any craigslist category code, e.g. `cto` (cars by owner), `ctd` (by dealer). |
| **🎯 Filters** (craigslist applies them) | | |
| `subarea`, `postalCode`, `searchDistance` | text / number | Sub-area (`brk`, `mnh`, `eby`) or a ZIP + radius in miles. |
| `minPrice`, `maxPrice`, `freeOnly` | number / bool | Price range in the city's currency; free items only. |
| `sellerType`, `condition` | select | Owner / dealer; new … salvage. |
| `hasImage`, `postedToday`, `searchTitlesOnly`, `hideDuplicates`, `deliveryAvailable` | bool | craigslist's own checkboxes. |
| `minBedrooms` … `maxSqft`, `catsOk`, `dogsOk` | number / bool | Housing filters. |
| `makeModel`, `minYear`, `maxYear`, `minOdometer`, `maxOdometer` | text / number | Vehicle filters. |
| `extraSearchParams` | JSON | Any other craigslist search parameter, e.g. `{"auto_title_status": 1, "laundry": [1, 4]}`. |
| `sort` | select | Newest (default), oldest, relevance, price up/down, distance. |
| **✂️ Refine results** (never charged) | | |
| `postedWithinHours`, `excludeKeywords`, `includeNearby`, `withContactOnly` | number / list / bool | Date window, keyword blocklist, neighbouring-city padding, only postings with a phone or email. |
| **➕ Extra data** | | |
| `includeDetails` | bool | Default **on**: read each posting page. Off = search-card fields only. |
| `imageSize` | select | 600x450 (default), 1200x900, 300x300, 50x50. |
| **🔁 Monitoring** | | |
| `monitorMode`, `monitorStoreName`, `includePriceChanges` | bool / text | Only postings listed since the previous run; optional price-change rows. |
| **📦 Output** | | |
| `maxResults` | number | Total postings, default 100. 0 = no limit. |
| `maxResultsPerSearch`, `compact`, `descriptionMaxLength` | number / bool | Per-search cap, core-fields-only rows, description cut. |
| **⚙️ Advanced** | | |
| `proxyConfiguration`, `maxConcurrency` | proxy / number | Not needed (direct connections work); a proxy is used only for requests craigslist refuses. Default 10 parallel requests. |

#### Input JSON

```json
{
  "locations": ["losangeles", "sandiego"],
  "category": "cta",
  "searchQueries": ["tacoma"],
  "sellerType": "owner",
  "minYear": 2012,
  "maxOdometer": 150000,
  "maxPrice": 25000,
  "maxResults": 200
}
```

#### Keep keywords short

craigslist requires every word of a keyword to appear in the posting, so `honda civic` works and `reliable honda civic low miles` usually returns nothing. Add several short keywords instead of one long one; each becomes its own search.

#### Going past 10,000 postings

craigslist answers any one search with at most 10,000 postings (the run summary shows craigslist's own total next to what was reachable). For a bigger pull, split the search by `subarea`, by price range, or by category.

### ⬆️ Output

One row per posting. A real row from our Los Angeles cars test run (description shortened):

```json
{
  "postId": "7983181227",
  "url": "https://www.craigslist.org/view/d/hermosa-beach-jeep-wrangler-rubicon-low/4haHCzn3AMkzjfpkwGjYFP",
  "title": "Jeep Wrangler Rubicon, Low 72K miles.  Lifted Off road ready",
  "price": 19995,
  "currency": "USD",
  "categoryName": "cars & trucks - by dealer",
  "sellerType": "dealer",
  "region": "losangeles",
  "subareaName": "central LA 213/323",
  "latitude": 33.8643,
  "longitude": -118.3955,
  "street": "303 Pacific Coast highway",
  "city": "Hermosa Beach",
  "postalCode": "90254",
  "postedAt": "2026-10-14T01:37:02.000Z",
  "expiresAt": "2026-11-13T01:37:02.000Z",
  "description": "2016 JEEP WRANGLER UNLIMI\ncall or text zach 310-533-7690 ...",
  "year": 2016,
  "makeModel": "Jeep Wrangler JK Rubicon",
  "odometer": 72650,
  "vin": "1C4BJWFG2GL321043",
  "phoneNumbers": ["(310) 533-7690"],
  "imageCount": 22,
  "scrapedAt": "2026-10-14T02:20:00.823Z"
}
```

#### Fields and how often they are filled

Measured on five 100-posting test runs with details on (2026-10-14): SF bay area for sale, Los Angeles cars, Chicago apartments, Los Angeles jobs, Chicago services.

| Field | For sale | Cars | Apartments | Jobs | Services |
|---|---|---|---|---|---|
| `title`, `url`, `postId`, `description`, `postedAt`, `latitude`/`longitude` | 100% | 100% | 100% | 100% | 100% |
| `price` | 96% | 97% | 100% | — | — |
| `city`, `postalCode` | 93% | 96% | 100% | 51% | — |
| `street` | 3% | 34% | 90% | 23% | 14% |
| `updatedAt` (edited postings) | 88% | 29% | 31% | 30% | 37% |
| `expiresAt` | 100% | 96% | 100% | 100% | 100% |
| `imageUrls` | 97% | 99% | 96% | 33% | 81% |
| `year`, `makeModel`, `odometer` | — | 100% | — | — | — |
| `vin` | — | 51% | — | — | — |
| `bedrooms`, `bathrooms`, `housingType` / `sqft` | — | — | 100% / 81% | — | — |
| `compensation`, `employmentType`, `jobTitle` / `company` | — | — | — | 98–99% / 52% | — |
| `phoneNumbers` / `emails` | 2% / 0% | 42% / 1% | 82% / 0% | 29% / 8% | 62% / 11% |
| `moreAdsBySellerUrl` | 5% | 34% | — | — | — |

"—" means craigslist does not show that field in that section. `attributes` carries every other attribute the posting has, keyed by craigslist's own field names (`auto_title_status`, `laundry`, `parking`, `rent_period`, `experience_level`...). Events rows carry `eventFirstDate`/`eventLastDate`, housing rows `openHouseDates` when the poster set them. Contact details come only from what the poster wrote in the posting; craigslist's anonymous reply relay is not revealed.

### Use cases

- 🚗 **Used-car buyers and dealers:** private-party cars by make, year and mileage across many cities, with VIN and the seller's phone when written.
- 🏠 **Rental and real-estate investors:** rents, beds/baths/sqft, street and ZIP for comps, FSBO and landlord leads.
- 💼 **Recruiters and job-market research:** job titles, companies and posted pay by city and category.
- 📞 **Lead generation:** service providers and dealers that publish a phone or email (`withContactOnly`).
- 📈 **Price research and arbitrage:** asking prices for any item category, newest first, on a schedule.
- 🔔 **Alerts:** monitor mode + an Apify schedule + a webhook or Slack integration = new-posting alerts.

### How much does it cost to scrape craigslist?

Craigslist Scraper is pay-per-event (the Pricing tab always shows the live rate): one **listing** event per posting delivered to your dataset. There is no start fee, and filtered, already-seen, nearby-padding and deleted postings are never charged.

| Postings delivered | Cost at $0.45 per 1,000 |
|---|---|
| 100 | $0.045 |
| 1,000 | $0.45 |
| 10,000 | $4.50 |

Apify's free plan includes $5 of monthly credit.

### Integrations, API, scheduling & MCP

Run it on a **schedule** (hourly, daily) with **Only new postings** on, and push results to Google Sheets, Slack, email, a webhook, Make, Zapier or n8n from the Integrations tab. Call it from code with the [Apify API](https://apify.com/scrapersdelight/craigslist-scraper/api) (`apify-client` for [Python](https://apify.com/scrapersdelight/craigslist-scraper/api/python) and [JavaScript](https://apify.com/scrapersdelight/craigslist-scraper/api/javascript)), or let an AI agent use it through the [Apify MCP server](https://apify.com/scrapersdelight/craigslist-scraper/api/mcp). `compact: true` keeps rows small for LLM pipelines.

### More marketplace and lead scrapers

- [Facebook Marketplace Scraper](https://apify.com/topapi/facebook-marketplace-scraper) — use it when the same items are listed on Marketplace.
- [Cars.com Dealer Scraper](https://apify.com/scrapersdelight/cars-com-dealer-scraper) — car dealers with phone, website and ratings.
- [CarGurus Scraper](https://apify.com/scrapersdelight/cargurus-dealer-scraper) — car dealer leads with phone and ratings.
- [Zillow Agent Leads Scraper](https://apify.com/scrapersdelight/zillow-agent-leads-scraper) — real-estate agents with phone, email and license.
- [HiBid Auction Scraper](https://apify.com/scrapersdelight/hibid-scraper) — auction lots, bids and prices in the USA and Canada.

### Limits & empty runs

- craigslist returns at most **10,000 postings per search**; the run summary (`RUN_SUMMARY` in the key-value store) shows craigslist's own total, what was reachable and what was delivered, per search.
- Speed measured on our test runs: about 3 seconds of scraping for 100 postings with details and about 19 seconds for 1,000; without details, 1,000 postings take a handful of requests.
- A search with no results ends with a clear message and costs nothing. A posting link that has been deleted or has expired comes back as a free row with `isDeleted: true`.
- Latitude/longitude are the pin craigslist shows, which the poster may have placed at neighborhood level.
- Small result lists get padded by craigslist with postings from neighbouring cities; those are skipped unless you turn on **Include nearby areas** (then marked `isNearby: true`).

### FAQ

#### How much does Craigslist Scraper cost?

One listing event per delivered posting, no start fee (see the cost table above and the Pricing tab). Filtered, already-seen and deleted postings are free.

#### How many postings can Craigslist Scraper return?

Everything craigslist shows for a search, up to its 10,000-per-search ceiling, across as many cities and keywords as you give it. Use `maxResults` to cap a run.

#### Can I run Craigslist Scraper on a schedule and get only new postings?

Yes. Turn on **Only new postings (monitor)** and schedule the task. Each search remembers what it delivered; later runs return only postings listed since then, and **Also return price changes** re-delivers a remembered posting with `changeType: PRICE_CHANGED` and `previousPrice`. A posting an earlier run delivered without its posting page (details off) comes back once with `changeType: DETAILS` when a run reads posting pages.

#### Does Craigslist Scraper need a login, cookies or a craigslist API key?

No. It reads craigslist's public search data and posting pages, the same ones any visitor sees.

#### Can Craigslist Scraper get the seller's phone number or email?

When the poster wrote one in the posting, yes: `phoneNumbers` and `emails`, and `withContactOnly` keeps just those postings. craigslist's anonymous reply relay is not revealed.

#### Which cities and countries does Craigslist Scraper cover?

All 707 craigslist city sites, including Canada, the UK, Europe, Asia and Australia. Prices come in the city's currency (`currency`). Use `all-us`, `all-ca` or `all-gb` to search every city of a country.

#### Why did Craigslist Scraper return fewer postings than I expected?

Check `RUN_SUMMARY`: it lists craigslist's own total for every search and how many postings each refine filter removed. Long keywords are the usual cause — craigslist needs every word to appear.

#### Can I use Craigslist Scraper with the Apify API or MCP?

Yes — see the API tab for Python, JavaScript and HTTP examples, or connect an AI agent through the Apify MCP server.

#### Can I paste my own craigslist search link?

Yes. Paste it into **Craigslist URLs** — old `sfbay.craigslist.org/search/...` links and new `www.craigslist.org/search/area/...` links both work, and the search keeps every filter in the link.

#### Your feedback

Found a bug or need a field? Open an issue on the [Issues tab](https://apify.com/scrapersdelight/craigslist-scraper/issues/open) and we will look at it quickly.

### Disclaimer

Craigslist Scraper is an independent tool and is not affiliated with, endorsed by or sponsored by craigslist, Inc. It reads only public craigslist pages — no login, no paid features. You are responsible for how you use the data, including craigslist's terms of use and the data-protection law that applies to you.

# Actor input Schema

## `startUrls` (type: `array`):

Search pages or single postings, old or new link style, e.g. "https://sfbay.craigslist.org/search/sss?query=bike", "https://www.craigslist.org/search/area/newyork?cat=cta", a posting link. A pasted search keeps its own filters.

## `searchQueries` (type: `array`):

One search per keyword, e.g. "honda civic", "standing desk". craigslist needs every word to appear, so keep it short. Empty = every posting in the category.

## `locations` (type: `array`):

craigslist city sites: the subdomain ("sfbay", "newyork", "toronto", "london"), a craigslist link, or a preset: "all-us", "all-ca", "all-gb", "all". Empty (and no URLs) = SF bay area.

## `category` (type: `string`):

craigslist section to search. "All for sale" covers every for-sale category; a narrower one (cars+trucks, apts / housing, jobs...) uses craigslist's own category filter.

## `categoryCode` (type: `string`):

Any craigslist category code, e.g. "cto" (cars by owner), "ctd" (cars by dealer), "bik". Overrides the dropdown when filled.

## `subarea` (type: `string`):

A craigslist sub-area code inside the city, e.g. "brk" (Brooklyn), "mnh" (Manhattan), "eby" (East Bay). Empty = the whole city.

## `postalCode` (type: `string`):

Search around this ZIP or postal code (craigslist picks the city from it), e.g. "10001". Use with Search distance.

## `searchDistance` (type: `integer`):

Radius around the ZIP / postal code. 0 = craigslist's default.

## `minPrice` (type: `integer`):

Only postings priced at or above this, in the city's currency. craigslist ignores it where postings have no price (jobs, community).

## `maxPrice` (type: `integer`):

Only postings priced at or below this, in the city's currency.

## `freeOnly` (type: `boolean`):

Only postings marked free (for-sale categories).

## `sellerType` (type: `string`):

craigslist's own 'sold by' filter.

## `condition` (type: `array`):

Item condition (for-sale categories). Postings without a condition drop out when this is set.

## `hasImage` (type: `boolean`):

Only postings with at least one photo.

## `postedToday` (type: `boolean`):

Only postings from the last 24 hours (craigslist's own filter).

## `searchTitlesOnly` (type: `boolean`):

Match keywords against titles only, not the posting body.

## `hideDuplicates` (type: `boolean`):

Let craigslist bundle near-identical reposts into one result.

## `deliveryAvailable` (type: `boolean`):

Only for-sale postings where the seller offers delivery.

## `minBedrooms` (type: `integer`):

Housing only.

## `maxBedrooms` (type: `integer`):

Housing only.

## `minBathrooms` (type: `integer`):

Housing only.

## `maxBathrooms` (type: `integer`):

Housing only.

## `minSqft` (type: `integer`):

Housing only (square feet as the poster entered them).

## `maxSqft` (type: `integer`):

Housing only.

## `catsOk` (type: `boolean`):

Housing: only postings that allow cats.

## `dogsOk` (type: `boolean`):

Housing: only postings that allow dogs.

## `makeModel` (type: `string`):

Vehicles: craigslist's make/model filter, e.g. "toyota tacoma".

## `minYear` (type: `integer`):

Vehicles only.

## `maxYear` (type: `integer`):

Vehicles only.

## `minOdometer` (type: `integer`):

Vehicles only (miles as posted).

## `maxOdometer` (type: `integer`):

Vehicles only.

## `extraSearchParams` (type: `object`):

Any other craigslist search parameter, as in its URLs, e.g. {"auto_title_status": 1, "laundry": \[1, 4], "employment_type": 1, "is_telecommuting": 1}.

## `sort` (type: `string`):

Order craigslist returns results in. Pasted URLs keep their own sort.

## `postedWithinHours` (type: `integer`):

Keep only postings posted in the last N hours. Pairs well with a schedule. 0 = no limit.

## `excludeKeywords` (type: `array`):

Drop postings whose title (or body, with details on) contains any of these, e.g. "wanted", "parts only".

## `includeNearby` (type: `boolean`):

craigslist pads small result lists with postings from neighbouring cities ("more from nearby areas"). On = keep them (isNearby: true); off = only the city you searched.

## `withContactOnly` (type: `boolean`):

Keep only postings whose body shows a phone number or email address (turns details on).

## `includeDetails` (type: `boolean`):

Open each posting for its full description, attributes (year, odometer, VIN, beds, baths...), all photos, street and postal code, updated time, and phones/emails written in the body. Off = search-card fields only, faster.

## `imageSize` (type: `string`):

Size of the photo links in imageUrls.

## `monitorMode` (type: `boolean`):

Remember delivered postings per search and return only postings no earlier run delivered. The first run returns everything up to your limits.

## `monitorStoreName` (type: `string`):

Named key-value store that keeps the memory. Use a different name per independent watch list.

## `includePriceChanges` (type: `boolean`):

With monitoring on, also return a remembered posting again when its price changed (changeType PRICE_CHANGED, previousPrice).

## `maxResults` (type: `integer`):

Total postings across all searches. craigslist returns at most 10,000 postings per search; split by sub-area or price to go further. 0 = no limit.

## `maxResultsPerSearch` (type: `integer`):

Cap for each city x keyword search (or pasted URL). 0 = only the total limit applies.

## `compact` (type: `boolean`):

Core fields only (id, link, title, price, place, date, description, contacts, photos) - small rows for AI agents and spreadsheets.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full text.

## `proxyConfiguration` (type: `object`):

Not needed: craigslist answers direct connections. A proxy you add here is used only for requests craigslist refuses.

## `maxConcurrency` (type: `integer`):

Posting pages fetched at the same time.

## Actor input object example

```json
{
  "startUrls": [],
  "searchQueries": [
    "bike"
  ],
  "locations": [
    "sfbay"
  ],
  "category": "sss",
  "categoryCode": "",
  "subarea": "",
  "postalCode": "",
  "searchDistance": 0,
  "freeOnly": false,
  "sellerType": "all",
  "condition": [],
  "hasImage": false,
  "postedToday": false,
  "searchTitlesOnly": false,
  "hideDuplicates": false,
  "deliveryAvailable": false,
  "catsOk": false,
  "dogsOk": false,
  "makeModel": "",
  "extraSearchParams": {},
  "sort": "date",
  "postedWithinHours": 0,
  "excludeKeywords": [],
  "includeNearby": false,
  "withContactOnly": false,
  "includeDetails": true,
  "imageSize": "600x450",
  "monitorMode": false,
  "monitorStoreName": "craigslist-monitor",
  "includePriceChanges": false,
  "maxResults": 20,
  "maxResultsPerSearch": 0,
  "compact": false,
  "descriptionMaxLength": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxConcurrency": 10
}
```

# Actor output Schema

## `listings` (type: `string`):

The dataset of craigslist postings (one item per posting).

## `summary` (type: `string`):

Per search: craigslist's own result total, postings listed and delivered, filters applied, deleted and unreachable postings, transport totals.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "bike"
    ],
    "locations": [
        "sfbay"
    ],
    "category": "sss",
    "includeDetails": true,
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["bike"],
    "locations": ["sfbay"],
    "category": "sss",
    "includeDetails": True,
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/craigslist-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "bike"
  ],
  "locations": [
    "sfbay"
  ],
  "category": "sss",
  "includeDetails": true,
  "maxResults": 20
}' |
apify call scrapersdelight/craigslist-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/craigslist-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/E4eAv98dBuPbcgEPm/builds/dWRgDDXsSqjh7aJ0E/openapi.json
