# Craigslist Scraper ($1.45/1K): Search, Deals & Monitoring (`tsutseisoftware/craigslist-scraper`) Actor

Scrape Craigslist in any US, Canadian or international city, state or country: for sale, cars, housing, jobs, gigs, services. Price, place, photos, bedrooms, salary, odometer; details, deal score, new-posting alerts. No login.

- **URL**: https://apify.com/tsutseisoftware/craigslist-scraper.md
- **Developed by:** [Tsutsei Software](https://apify.com/tsutseisoftware) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.19 / 1,000 postings

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/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

## Craigslist Scraper & New Posting Monitor

Get postings from **Craigslist** in any US, Canadian or international city as clean, ready-to-use data: title, **price as a number** with its currency, date, category, **owner or dealer**, site, sub-area and neighborhood, **map point**, every photo, and where the posting has them **bedrooms and floor area**, **salary and company** or the **odometer**. Optionally the actor adds each posting's own data: the whole description (phone numbers and e-mails removed), **every attribute** (condition, make and model, year, title status, laundry, parking, pets, employment type…), the created and updated dates, **reposts** and the street address of rentals and businesses.

Search **any section**: for sale, cars & trucks, housing, jobs, gigs, services, community, events and resumes, by keyword or whole categories, on **one site, a sub-area, a whole state or province, or a whole country** in one run. Or paste **any Craigslist URL** with its filters, in the old or the new address form. Up to **10,000 postings per search**, and every posting gets a **deal score**: its price against the median of comparable postings, so bargains stand out.

Built for **watching Craigslist**: schedule it every few minutes in monitoring mode and you get, and pay for, only the postings that are **new or cheaper**, with an **alert to Telegram, Slack, Discord, WhatsApp or your webhook**. It can also report **removed postings**.

**Price:** $1.45 per 1 000 postings (down to $1.19 on higher plans), below the most used Craigslist scrapers; an hourly monitor of one search ≈ **$2.30 a month** plus the new postings. No proxy, no account and no extra platform costs.

### Why use this Craigslist scraper?

- **Less than the most used Craigslist scrapers:** $1.45 per 1 000 postings with no extra platform costs; posting details cost $0.05 per 1 000 more.
- **Many sites in one run:** a list of cities, a sub-area (Brooklyn, South Bay), a whole state (US-CA) or a whole country (US, CA, GB); a posting found by several searches is saved once.
- **Up to 10,000 postings per search**, read in seconds, with the website's own filters: price, ZIP code and radius, owner or dealer, photos, posted today, make and model, year, odometer, bedrooms, bathrooms, area, cats and dogs.
- **A monitor that pays only for news:** a scheduled check without news costs about $0.003 and returns only new and cheaper postings with the previous price, and optionally the removed ones.
- **Deal score on every posting, free:** comparableMedianPrice, priceVsMedianPercent and dealScore (50 = the usual price, higher = cheaper) against comparable postings of the same category.
- **Privacy-first:** Craigslist shows no names, and the actor removes phone numbers, e-mails and the names next to them from titles and descriptions, never reads what is behind the reply button, rounds the map point of private posters to about 1 km and gives a street address only for rentals, jobs and businesses.

| | This actor | Typical Craigslist scraper |
|---|---|---|
| Price per 1 000 postings | **$1.45** (with details $1.50) | $1.50–6.00 for the most used ones |
| Many cities, a state or a country in one run | **yes** | some (a list of cities) |
| Postings per search | **up to 10,000** | often a few hundred |
| New and cheaper postings only, alerts | **yes** (Telegram, Slack, Discord, WhatsApp, webhook) | some |
| Removed postings, reposts | **yes** | no |
| Deal score, market summary | **yes** | no |
| Phone numbers and e-mails of private posters | **never** | some sell them |

### What data can you get?

| Field | Example |
|---|---|
| Title, URL, posting ID | Apple iPhone 12 - 64GB (black) - unlocked w/charger - like new, https://www.craigslist.org/view/d/…/okpBe4Sd7iBVbvuZEbobbB, 7959271665 |
| Price | 350 USD (CAD in Canada, GBP in the UK, EUR in the euro countries…) |
| Date | postedAt 2026-11-15T05:48:15Z (posted or last renewed) |
| Category | mob, cell phones - by owner, section for sale, sellerType `owner` (or `dealer`) |
| Place | site newyork, sub-area manhattan, neighborhood Upper West Side, state NY, country US, latitude and longitude |
| Photos | the first photo, all photos and their number |
| Housing (from the search) | bedrooms 2, areaSize 840, areaUnit ft2 |
| Jobs and gigs (from the search) | salary "$20.0 per hour", company Waste Connections, jobTitle Inside Sales Representative |
| Cars (from the search) | odometer 182 000 mi |
| With **Add posting details** | description; attributes {"condition": "excellent", "make/model": "subaru crosstrek", "year": "2017", "title status": "clean", "transmission": "automatic"} or {"bathrooms": "1", "laundry": "w/d in unit", "parking": "carport", "cats are OK - purrr": "yes"}; condition, makeModel, year, bathrooms; createdAt, updatedAt, isRepost, repostOf; streetAddress of rentals and businesses; hasContactInfo |
| Deal score | comparableCount 12, comparableMedianPrice 380, priceVsMedianPercent −7.9, dealScore 54 |
| With **Monitoring** | changeType `new`, `updated`, `removed`, `reappeared`; previousPrice, priceChange, priceChangePercent, firstSeenAt, removedAt, removedReason |

Measured on 2 500 postings (15 Nov 2026): price 96–98 %, photo 93–95 %, map point 100 %, place 99 %, neighborhood 18 % in New York (where Craigslist names one), deal score 37 % of an "iphone" search (it needs comparable postings, so it works best with keyword searches).

### How to scrape Craigslist

1. Open the actor and enter **Search keywords** (or leave them empty for whole categories), **Locations** (newyork, sfbay, US-CA, US…) and **Categories**, or paste a Craigslist URL.
2. Set **Max postings** and, if you need them, the filters and options (posting details, monitoring, notifications).
3. Click **Start**. The postings appear in the dataset; export them to Excel, CSV or JSON, or get them through the API.
4. For a monitor, turn on **Monitoring: only new or changed postings**, add a notification channel and schedule the run (Schedules → every 15 minutes or every hour).

### Use cases

#### Alert me to every new iPhone 15 in New York under $500

```json
{
  "searchQueries": ["iphone 15"],
  "locations": ["newyork"],
  "categories": ["moa"],
  "maxPrice": 500,
  "onlyNewOrChanged": true,
  "monitoringKey": "iphone-nyc",
  "telegramBotToken": "123456:ABC…",
  "telegramChatId": "-1001234567890",
  "maxItems": 100
}
```

Schedule it every 15 minutes. The first run remembers the current postings; every next run returns only the new ones and the price drops, and sends them to Telegram.

#### Used Toyotas by owner in all of California

```json
{
  "locations": ["US-CA"],
  "categories": ["cta"],
  "makeModel": "toyota",
  "sellerType": "owner",
  "minYear": 2012,
  "maxPrice": 15000,
  "includeDetails": true,
  "maxItems": 2000
}
```

#### Two-bedroom rentals around a ZIP code

```json
{
  "locations": ["sfbay"],
  "categories": ["apa"],
  "postalCode": "94107",
  "searchDistance": 5,
  "minBedrooms": 2,
  "maxPrice": 4500,
  "dogsOk": true,
  "includeDetails": true,
  "maxItems": 500
}
```

#### Software jobs in several cities

```json
{
  "locations": ["sfbay", "seattle", "austin", "newyork"],
  "categories": ["sof"],
  "maxItems": 1000
}
```

#### Paste any search URL

```json
{
  "startUrls": [{ "url": "https://sfbay.craigslist.org/search/sby/cta?auto_make_model=honda%20civic&max_price=9000" }],
  "maxItems": 300
}
```

#### Bargains only: at least 25 % under the usual price

```json
{
  "searchQueries": ["dyson", "kitchenaid", "herman miller"],
  "locations": ["losangeles", "sandiego"],
  "maxPriceVsMedianPercent": -25,
  "maxItems": 500
}
```

#### Monitoring mode explained

The first run reads the search and remembers its postings (in your Apify account, under the Monitoring key). Each next run reads the newest postings and stops at the first ones it already knows, so a check without news costs about $0.003, and returns only postings that are new or whose title or price changed. With **report removed postings** (and **stop at known postings** off) the whole search is read every run, so postings that disappeared can be reported with their last price.

#### Notifications

After a run the saved postings (with Monitoring only the new, cheaper and removed ones) go to Telegram, Slack, Discord, WhatsApp or your own webhook: title, price and the previous price, place, deal score and link, never descriptions. Nothing is sent when nothing was saved, unless you turn **Notify only when something was found** off.

#### Market summary (SUMMARY)

Every successful run writes SUMMARY to its key-value store, free: how many postings the website reports and how many were read and saved, price median, quartiles, minimum and maximum per currency, top categories and places, and the shares of owners, dealers and postings with photos.

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

You pay only for what the run saves; there are no extra platform costs.

| Event | Price |
|---|---|
| Posting saved | **$1.45 per 1 000** (Bronze $1.39, Silver $1.29, Gold and higher $1.19) |
| Posting details (with **Add posting details**, and for posting URLs) | +$0.05 per 1 000 postings |
| Monitoring: page checked (every page of results a monitoring run reads) | $0.20 per 1 000 pages |
| Extra page (pages read beyond the saved postings, e.g. postings your filters left out) | $0.20 per 1 000 pages |
| Notification (a run that sent one) | $0.001 |
| Start of a run | $0.003 |

| Typical run | Price | Typical time |
|---|---|---|
| 100 postings | $0.15 | seconds |
| 1 000 postings | $1.45 | under a minute |
| 1 000 postings with details | $1.50 | about 17 minutes |
| 10,000 postings of one search | $14.50 | about a minute |
| Hourly monitor, a check without news | $0.003 | seconds |

With the $5 of free Apify credit each month you can get about 3 400 postings.

### Input example

```json
{
  "searchQueries": ["iphone"],
  "locations": ["newyork"],
  "categories": ["sss"],
  "maxItems": 20
}
```

### Output example

```json
{
  "id": "7959271665",
  "source": "craigslist",
  "url": "https://www.craigslist.org/view/d/new-york-apple-iphone-gb-black-unlocked/okpBe4Sd7iBVbvuZEbobbB",
  "postingUuid": "okpBe4Sd7iBVbvuZEbobbB",
  "title": "Apple iPhone 12 - 64GB (black) - unlocked w/charger - like new",
  "price": 350,
  "currency": "USD",
  "postedAt": "2026-11-15T05:48:15Z",
  "category": "mob",
  "categoryName": "cell phones - by owner",
  "section": "for sale",
  "sellerType": "owner",
  "site": "newyork",
  "siteName": "new york",
  "subarea": "mnh",
  "subareaName": "manhattan",
  "region": "NY",
  "country": "US",
  "neighborhood": "Upper West Side",
  "latitude": 40.79,
  "longitude": -73.98,
  "imageCount": 0,
  "searchQuery": "iphone",
  "detailsIncluded": true,
  "description": "Apple iPhone 12 - 64GB (black) - unlocked with charger - like new condition - Fully functional\n\n$350 or best offer…",
  "attributes": { "condition": "like new", "make / manufacturer": "Apple", "mobile OS": "apple iOS" },
  "condition": "like new",
  "makeModel": "Apple",
  "createdAt": "2026-09-02T04:32:11Z",
  "updatedAt": "2026-11-15T05:43:15Z",
  "isRepost": true,
  "repostOf": "7947060180",
  "hasContactInfo": true,
  "comparableCount": 18,
  "comparableMedianPrice": 380,
  "priceVsMedianPercent": -7.9,
  "dealScore": 54,
  "scrapedAt": "2026-11-15T08:00:00Z"
}
```

### Good to know

- **10,000 postings per search** is the most Craigslist gives for one search; the status message says when a search had more. Split it by price, sub-area or category.
- **Locations:** use the site name as in its address (newyork for newyork.craigslist.org, sfbay, losangeles, toronto, london), a sub-area (newyork/brk), a US state or Canadian province (US-CA, CA-ON) or a whole country (US has 413 sites, so a whole-country search takes a few minutes).
- **Duplicates:** Craigslist marks the same posting posted several times by one poster; **Hide duplicates** (on by default) keeps only the newest.
- **Deal score** compares a posting with comparable postings of the same category (the same item, not its accessories) that the run has seen. A score needs a few comparable postings, so it works best with keyword searches; otherwise it is null.
- **Dates:** postedAt is when the posting was posted or last renewed (Craigslist sorts by it); createdAt with details is when it was first created.
- A page the website rejects is retried once a little later, never from another IP address; if rejections continue, the run stops with what it has saved and says so.

### For AI agents and API users

Run it from the Apify API, the Apify MCP server, Make, Zapier or n8n. **Compact output** keeps the core fields (id, title, price, date, category, seller type, site, neighborhood, map point, photo, bedrooms and area, salary and company, odometer, deal score, link, monitoring fields). Every field is described in the dataset schema (Output tab).

### Troubleshooting

- **"is not a Craigslist site"**: use the name from the site's address (newyork, sfbay, chicago), a state (US-CA) or a country (US).
- **"No supported URL"**: paste a Craigslist search (`https://<site>.craigslist.org/search/…` or `https://www.craigslist.org/search/…`) or a posting (`…/view/d/<name>/<key>`).
- **"Craigslist does not accept your search"**: the category does not exist on that site; open the search in the browser and paste its address.
- **"refused the requests"**: run without a proxy (the default) and try again later.
- **Fewer postings than the website shows**: check **Max postings**, **Max postings per search**, the filters and **Hide duplicates**; the status message says what stopped the run.
- **Monitoring returned nothing**: nothing new since the last run with the same Monitoring key.

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### More classified-ad scrapers

The same deal score, monitoring and alerts for another classified-ad site:

- [Bazoš Scraper & New Ad Monitor](https://apify.com/tsutseisoftware/bazos-scraper): Bazoš.cz, .sk, .pl and .at: any section or search, deal score, car fields, new and cheaper ads with alerts
- [Facebook Marketplace Scraper](https://apify.com/tsutseisoftware/facebook-marketplace-scraper): any town, ZIP code or coordinates with a strict radius: price, place, seller, deal score, sold listings, alerts
- [Vinted Scraper](https://apify.com/tsutseisoftware/vinted-scraper): 24 Vinted country sites in one run: price, brand, size, condition in English, deal score, sold items, alerts
- [AutoScout24 Scraper](https://apify.com/tsutseisoftware/autoscout24-scraper): used and new cars from all 8 AutoScout24 countries: price rating, deal score, full specs, dealer stocks, sold listings, alerts
- [Kleinanzeigen Scraper & New Ad Monitor](https://apify.com/tsutseisoftware/kleinanzeigen-scraper): Germany's biggest classifieds: searches past 1,250 ads, deal score, vehicle and electronics fields, price check, new and cheaper ads with alerts

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape Craigslist?

It reads only publicly available data, without logging in, at most 60 requests per minute, slows down when the website asks, never changes IP address to get around a limit and never solves captchas or other challenges. It does not collect what is behind the reply button and removes phone numbers, e-mails and the names written next to them from titles and descriptions; free text can still contain a name a poster wrote elsewhere. You are responsible for how you use the data (e.g. privacy laws if you process anything personal, and the website's terms). This is an unofficial tool, not connected with craigslist, Inc.

#### How is it different from other Craigslist scrapers?

It costs less than the most used Craigslist scrapers, it searches many cities, a state or a whole country in one run, it reads up to 10,000 postings per search, its monitor returns only new and cheaper postings (and, if you want, the removed ones), and every posting gets a deal score.

#### Do I need a proxy?

No proxy needed.

#### How often should I run the monitor?

Every 5–15 minutes for a popular search, hourly or daily for a quiet one. A check without news costs about $0.003.

#### Can I get the poster's phone number or e-mail?

No. Craigslist hides them behind its reply button, and the actor never reads them; numbers and e-mails written in the text are removed.

#### Why is the deal score empty?

There were too few comparable postings in the run. Search a narrower keyword or more locations.

This actor is also known as a Craigslist API, Craigslist crawler, "Craigslist alert", "Craigslist search all cities" or Craigslist data extractor.

# Changelog

This Actor's version history is a separate document: https://apify.com/tsutseisoftware/craigslist-scraper/changelog.md

# Actor input Schema

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

What to search for, as you would type it on Craigslist (e.g. iphone 15, honda civic, 2br). Every keyword is searched in every location and category below. Leave empty to get whole categories.

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

Craigslist sites to search: the name from the site address (newyork, sfbay, losangeles, chicago, toronto, london) or its full name ("new york city"), a sub-area (newyork/brk, sfbay/sby), a US state or Canadian province (US-CA, US-TX, CA-ON) or a whole country (US, CA, GB). A posting found in several searches is saved once.

## `categories` (type: `array`):

Where to search (empty = all of FOR SALE). Every category is searched in every location.

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

Search pages copied from the browser with any filters, in the old or new address form (e.g. https://sfbay.craigslist.org/search/cta?auto_make_model=toyota\&max_price=15000 or https://www.craigslist.org/search/area/newyork?cat=apa\&min_bedrooms=2), and posting URLs (read with their details). A URL keeps its own filters; without a sort order it gets "Sort by".

## `sortBy` (type: `string`):

Order of the results. Newest first is best for monitoring new postings.

## `minPrice` (type: `number`):

In the currency of the site (USD in the US, CAD in Canada, GBP in the UK...).

## `maxPrice` (type: `number`):

In the currency of the site.

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

Search around this ZIP or postal code (with one location: the Craigslist site of the ZIP code).

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

Radius around the ZIP code.

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

For sale categories: private owners or dealers.

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

Only postings with at least one photo.

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

Only postings from today.

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

Match the keywords in titles only (not in the text).

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

For sale: only postings with delivery.

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

Cars & trucks, motorcycles...: e.g. toyota camry.

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

Oldest model year.

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

Newest model year.

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

In miles (km on sites outside the US and UK).

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

In miles (km on sites outside the US and UK).

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

Apartments, rooms, real estate.

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

Apartments, rooms, real estate.

## `minBathrooms` (type: `number`):

Apartments, rooms, real estate.

## `maxBathrooms` (type: `number`):

Apartments, rooms, real estate.

## `minArea` (type: `integer`):

Square feet (m² on sites that use them).

## `maxArea` (type: `integer`):

Square feet (m² on sites that use them).

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

Only places that allow cats.

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

Only places that allow dogs.

## `titleKeywords` (type: `array`):

Keep only postings whose title contains any (or all, see below) of these words.

## `keywordsMode` (type: `string`):

For "Title must contain" and "Text must contain".

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

Leave out postings whose title contains any of these words (e.g. case, broken, wanted).

## `onlyWithPrice` (type: `boolean`):

Leave out postings without a price (or priced at 0).

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

Craigslist marks the same posting posted several times; keep only the newest.

## `excludeOutlierPrices` (type: `boolean`):

Leave out postings priced at less than a fifth or more than five times the usual price of comparable postings.

## `maxPriceVsMedianPercent` (type: `integer`):

Keep only postings at most this many % above (or, negative, below) the usual price of comparable postings, e.g. -20 = at least 20 % cheaper.

## `minDealScore` (type: `integer`):

Keep only postings with at least this deal score (50 = the usual price, higher = cheaper).

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

Read every posting's own page: the description (phone numbers and e-mails removed), all attributes (condition, make and model, year, odometer, bathrooms, laundry, parking, pets, compensation, employment type...), every photo, the created and updated dates, whether it is a repost and, for housing and businesses, the street address. Charged as "Posting details" ($0.05 per 1 000 postings) and slower.

## `descriptionKeywords` (type: `array`):

With "Add posting details": keep only postings whose title or description contains any (or all) of these words.

## `excludeDescriptionKeywords` (type: `array`):

With "Add posting details": leave out postings whose title or description contains any of these words.

## `skipReposts` (type: `boolean`):

With "Add posting details": leave out postings that are a repost of an older posting.

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

Only the main fields: title, price, date, category, seller type, site, neighborhood, map point, photo, bedrooms and area, salary and company, odometer, deal score, URL.

## `maxItems` (type: `integer`):

Maximum number of postings saved. You pay per saved posting. 0 = no limit.

## `maxItemsPerSearch` (type: `integer`):

Maximum per keyword, location and category (or per URL). Empty = no limit.

## `onlyNewOrChanged` (type: `boolean`):

Return new postings, and postings whose price or title changed (with the previous price).

## `monitoringKey` (type: `string`):

Name of the remembered state; use a different key for every saved search. Empty = "default".

## `monitoringEarlyStop` (type: `boolean`):

With newest first: stop a search as soon as it reaches postings already known (fast, cheap checks every few minutes). Turn it off to see price changes of older postings and to report removed postings.

## `onlyNew` (type: `boolean`):

Return new postings only, not changed ones.

## `onlyPriceDrops` (type: `boolean`):

Of the changed postings, return only those whose price went down.

## `minPriceDropPercent` (type: `integer`):

Of the changed postings, return only those whose price went down by at least this many %.

## `includeRemovedListings` (type: `boolean`):

Postings of the previous run that are gone: the actor checks each one and returns it with removedReason removed (deleted or expired) or noLongerMatches (still online, no longer in the search). Works for searches read in full (up to 10,000 postings) with "Monitoring: stop at known postings" off. Each check is charged as a monitoring page.

## `skipFirstRun` (type: `boolean`):

The first run only remembers the postings and returns nothing; later runs return what is new.

## `resetMonitoring` (type: `boolean`):

Forget the remembered postings of this Monitoring key.

## `telegramBotToken` (type: `string`):

Token of your bot from @BotFather.

## `telegramChatId` (type: `string`):

Chat to send to.

## `slackWebhookUrl` (type: `string`):

Incoming webhook (https://hooks.slack.com/...).

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `webhookUrl` (type: `string`):

Any HTTPS URL (Zapier, Make, n8n, your server): receives the postings as JSON.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `notificationLimit` (type: `integer`):

How many postings the message lists.

## `notifyOnlyChanges` (type: `boolean`):

No message after a run that saved nothing.

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

No proxy needed. If Craigslist keeps refusing your runs, switch to Apify Proxy; a run through a residential proxy may be charged a little more to cover its traffic.

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "searchQueries": [
    "iphone"
  ],
  "locations": [
    "newyork"
  ],
  "categories": [
    "sss"
  ],
  "sortBy": "newest",
  "sellerType": "all",
  "hasImage": false,
  "postedToday": false,
  "searchTitlesOnly": false,
  "deliveryAvailable": false,
  "catsOk": false,
  "dogsOk": false,
  "keywordsMode": "any",
  "onlyWithPrice": false,
  "hideDuplicates": true,
  "excludeOutlierPrices": false,
  "includeDetails": false,
  "skipReposts": false,
  "compact": false,
  "maxItems": 20,
  "onlyNewOrChanged": false,
  "monitoringEarlyStop": true,
  "onlyNew": false,
  "onlyPriceDrops": false,
  "includeRemovedListings": false,
  "skipFirstRun": false,
  "resetMonitoring": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "sendErrorReports": true
}
```

# Actor output Schema

## `items` (type: `string`):

No description

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

No description

# 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": [
        "iphone"
    ],
    "locations": [
        "newyork"
    ],
    "categories": [
        "sss"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/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": ["iphone"],
    "locations": ["newyork"],
    "categories": ["sss"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/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": [
    "iphone"
  ],
  "locations": [
    "newyork"
  ],
  "categories": [
    "sss"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call tsutseisoftware/craigslist-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tsutseisoftware/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/9cZoREyHGP1bzuT5i/builds/UUCoyOlOULaeLOSMd/openapi.json
