# Craigslist Classifieds Scraper — No Login Required (`crowdpull/craigslist-scraper`) Actor Extract Craigslist listings across real estate, cars, jobs, gigs, services, for-sale, free stuff, community, and events. No login or cookies needed. Supports API-first search, postal-radius scoping, detail/contact enrichment, Smart Scrape, garage-sale dates, and real estate presets. - **URL**: https://apify.com/crowdpull/craigslist-scraper.md - **Developed by:** [Crowd Pull](https://apify.com/crowdpull) (community) - **Categories:** E-commerce, Real estate, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 search-card listing extracteds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Classifieds Scraper Extract Craigslist listings across real estate, cars, jobs, gigs, services, for-sale, free stuff, community, events, resumes, and direct post URLs. No login or cookies needed. This actor is API-first. It calls Craigslist's public JSON search endpoint, decodes listing rows, and optionally hydrates post pages for full descriptions and attributes. Real estate is the highlighted workflow, with presets and output fields for apartments, rooms, sublets, FSBO, office/commercial, parking, beds, baths, square feet, pets, and furnished searches. ### Features - All major Craigslist categories in one actor - Real estate presets and dedicated dataset view - Postal-radius scoping for accurate geography - Multi-city and multi-category fanout - Search-card mode for fast, low-cost runs - Optional detail enrichment for full descriptions and attributes - Optional public contact extraction from posting pages, including visible phone/email text, mailto/tel links, and Craigslist reply URL metadata - Owner/dealer/all `listingType`, native duplicate hiding, nearby search, delivery-available, and condition filters - Garage and moving sale date filters with `startDate` / `endDate` - Deleted, expired, and unavailable detail-page status fields for direct URLs and detail-enriched searches - Smart Scrape mode to emit only new or changed listings on scheduled runs - Canonical listing URLs, posting IDs, timestamps, images, location, price, and category-specific fields ### Example Input ```json { "searches": [ { "city": "newyork", "postalCode": "10001", "searchDistance": 5, "category": "apa", "query": "studio", "listingType": "owner", "minBedrooms": 0, "maxPrice": 3500, "includeDetails": true, "includeContactInfo": true, "maxResultsPerSearch": 50 }, { "city": "sfbay", "postalCode": "94103", "searchDistance": 25, "category": "cta", "query": "honda civic", "condition": ["good", "excellent"], "deliveryAvailable": true, "maxResultsPerSearch": 100 }, { "city": "sfbay", "postalCode": "94103", "searchDistance": 25, "category": "gms", "startDate": "2026-06-06", "endDate": "2026-06-07", "maxResultsPerSearch": 50 } ], "onlyNew": false } ```` ### Smart Scrape Set `onlyNew` to `true` and keep the same `cacheName` for scheduled runs. The actor stores a material hash for each posting ID and only emits rows that are new or meaningfully changed. ```json { "city": "detroit", "postalCode": "48201", "searchDistance": 20, "categories": ["apa", "roo", "sub", "rea"], "onlyNew": true, "cacheName": "detroit-housing-monitor", "maxResultsPerSearch": 200 } ``` ### Output Each dataset item is a normalized Craigslist listing: ```json { "type": "listing", "source": "craigslist", "status": "ok", "postingId": "7938170495", "url": "https://newyork.craigslist.org/brk/apa/d/brooklyn-no-fee-lrg-studio-loft-home/7938170495.html", "title": "No Fee, Lrg Studio Loft + Home Office/1 Bed", "category": "apa", "categoryLabel": "apartments", "listingType": "owner", "city": "newyork", "price": 3450, "priceText": "$3,450", "postedAt": "2026-06-01T23:32:13.000Z", "updatedAt": "2026-06-02T12:14:00.000Z", "neighborhood": "Bed-Stuy", "bedrooms": 1, "squareFeet": 855, "imageUrls": ["https://images.craigslist.org/example_600x450.jpg"], "listingStatus": "active", "isDeleted": false, "isExpired": false, "contactInfoAvailable": true, "contactPhones": ["212-555-0100"], "replyUrlTemplate": "https://newyork.craigslist.org/reply/...", "searchPostalCode": "10001", "searchDistance": 5, "scrapedAt": "2026-06-02T00:00:00.000Z" } ``` ### Pricing Recommended pay-per-event pricing: - Actor start: low fixed start fee - `listing-extracted`: about $0.00275 to $0.0035 per search-card listing - `detail-enriched`: about $0.00625 to $0.0075 per detail/contact-enriched listing Detail/contact enrichment is optional so broad classifieds users can run cheaply while higher-value real estate monitoring pays for richer rows. ### Limitations - Craigslist's JSON endpoint scopes reliably by postal code and search radius. The actor includes default postal codes for common city subdomains, but exact workflows should pass `postalCode`. - The actor does not log in, bypass reply flows, or extract private contact details. `includeContactInfo` only parses public posting-page text, public mailto/tel links, and Craigslist reply metadata when exposed. - Detail enrichment fetches public posting pages and may miss fields that Craigslist does not expose in public HTML. - Craigslist can remove or expire postings at any time; direct post URLs and detail-enriched rows surface `listingStatus`, `isDeleted`, `isExpired`, and `detailFailureReason` when this is detectable. # Actor input Schema ## `searches` (type: `array`): Run one or more Craigslist searches. Each search can override city, postal code, category, query, filters, and max results. Leave empty to use the top-level fields below. ## `startUrls` (type: `array`): Optional Craigslist search/category/post URLs. Search URL filters are preserved when possible. Direct post URLs are hydrated as detail records. ## `city` (type: `string`): Craigslist city subdomain such as newyork, sfbay, detroit, seattle, chicago, losangeles, or miami. A default postal code is used for popular cities; add postalCode for exact scoping. ## `cities` (type: `array`): Optional list of Craigslist city subdomains. Each city runs the same top-level filters. Add postalCode inside searches\[] for exact per-city scoping. ## `postalCode` (type: `string`): ZIP/postal code for accurate Craigslist API scoping. Recommended whenever geography matters. ## `searchDistance` (type: `integer`): Radius around the postal code in miles. ## `category` (type: `string`): Craigslist category code. Real estate examples: apa apartments, hhh all housing, rea real estate for sale, roo rooms, sub sublets, vac vacation rentals, off office, prk parking. Broad examples: sss for sale, cta cars, gms garage sales, jjj jobs, ggg gigs, srv services, ccc community, eee events, zip free stuff. ## `categories` (type: `array`): Optional list of category codes to run with the same filters. Use this for all-housing or all-classifieds fanout. ## `query` (type: `string`): Free-text Craigslist search query. Leave empty to browse the latest listings in the category. ## `minPrice` (type: `integer`): Minimum price in the local Craigslist currency. ## `maxPrice` (type: `integer`): Maximum price in the local Craigslist currency. ## `postedToday` (type: `boolean`): Only return listings Craigslist marks as posted in the last 24 hours. ## `hasPic` (type: `boolean`): Only return listings with at least one image. ## `ownerOnly` (type: `boolean`): Compatibility toggle for owner/private posts. Prefer listingType for owner/dealer/all workflows. ## `listingType` (type: `string`): Craigslist owner/dealer filter. Use owner for private-owner real-estate or vehicle searches, dealer for dealer listings, or all for no seller filter. ## `hideDuplicates` (type: `boolean`): Ask Craigslist to bundle/hide duplicate postings when supported by the category. ## `searchNearby` (type: `boolean`): Ask Craigslist to include nearby areas when supported by the search endpoint. ## `deliveryAvailable` (type: `boolean`): Only return listings marked with delivery available when Craigslist supports the filter. ## `condition` (type: `array`): Optional Craigslist condition filters. Use values like new, like-new, excellent, good, fair, salvage, or numeric Craigslist codes 10/20/30/40/50/60. ## `sort` (type: `string`): Craigslist sort order. ## `minBedrooms` (type: `integer`): Minimum number of bedrooms for housing categories. ## `maxBedrooms` (type: `integer`): Maximum number of bedrooms for housing categories. ## `minBathrooms` (type: `number`): Minimum number of bathrooms for housing categories. ## `maxBathrooms` (type: `number`): Maximum number of bathrooms for housing categories. ## `minSqft` (type: `integer`): Minimum square footage for housing categories. ## `maxSqft` (type: `integer`): Maximum square footage for housing categories. ## `catsOk` (type: `boolean`): Only include housing listings that allow cats when Craigslist supports the filter. ## `dogsOk` (type: `boolean`): Only include housing listings that allow dogs when Craigslist supports the filter. ## `furnished` (type: `boolean`): Only include furnished housing listings when Craigslist supports the filter. ## `startDate` (type: `string`): Garage-sale date filter start, formatted as YYYY-MM-DD. ## `endDate` (type: `string`): Garage-sale date filter end, formatted as YYYY-MM-DD. Date ranges are capped at 31 days. ## `includeDetails` (type: `boolean`): Fetch each posting page for full description, attribute text, and richer images. Search-card mode is faster and cheaper. ## `includeContactInfo` (type: `boolean`): Fetch each public posting page and extract visible phone/email text, mailto/tel links, and Craigslist reply URL metadata when exposed. ## `onlyNew` (type: `boolean`): Use a named key-value store cache to emit only listings that are new or materially changed since a previous run. ## `cacheName` (type: `string`): Named key-value store used by onlyNew. Keep the same value for scheduled monitor runs. ## `maxResultsPerSearch` (type: `integer`): Maximum listings to save per normalized search. Craigslist API batches are fetched in 360-item pages. ## `maxConcurrency` (type: `integer`): Maximum concurrent detail-page fetches when includeDetails or includeContactInfo is enabled. ## `requestDelayMs` (type: `integer`): Delay between Craigslist search API batch requests. ## `maxRequestRetries` (type: `integer`): Retry attempts for transient Craigslist API/detail failures. ## `saveDebugHtml` (type: `boolean`): Save failed detail-page HTML/error snippets to the default key-value store. ## Actor input object example ```json { "searches": [ { "city": "newyork", "postalCode": "10001", "searchDistance": 5, "category": "apa", "query": "studio", "listingType": "owner", "maxResultsPerSearch": 50, "includeDetails": true, "includeContactInfo": true }, { "city": "detroit", "postalCode": "48201", "searchDistance": 20, "category": "zip", "maxResultsPerSearch": 50 } ], "startUrls": [ { "url": "https://sfbay.craigslist.org/search/cta?query=honda%20civic&postal=94103&search_distance=25" } ], "city": "newyork", "postalCode": "10001", "searchDistance": 25, "category": "apa", "query": "studio", "postedToday": false, "hasPic": false, "ownerOnly": false, "listingType": "all", "hideDuplicates": false, "searchNearby": false, "deliveryAvailable": false, "sort": "date", "catsOk": false, "dogsOk": false, "furnished": false, "includeDetails": false, "includeContactInfo": false, "onlyNew": false, "cacheName": "craigslist-scraper-cache", "maxResultsPerSearch": 100, "maxConcurrency": 4, "requestDelayMs": 250, "maxRequestRetries": 3, "saveDebugHtml": false } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (type: `string`): No description ## `searchSpecs` (type: `string`): No description ## `failedTargets` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searches": [ { "city": "newyork", "postalCode": "10001", "searchDistance": 5, "category": "apa", "query": "studio", "listingType": "owner", "maxResultsPerSearch": 50, "includeDetails": true, "includeContactInfo": true }, { "city": "detroit", "postalCode": "48201", "searchDistance": 20, "category": "zip", "maxResultsPerSearch": 50 } ], "startUrls": [ { "url": "https://sfbay.craigslist.org/search/cta?query=honda%20civic&postal=94103&search_distance=25" } ], "city": "newyork", "postalCode": "10001", "category": "apa", "query": "studio" }; // Run the Actor and wait for it to finish const run = await client.actor("crowdpull/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 = { "searches": [ { "city": "newyork", "postalCode": "10001", "searchDistance": 5, "category": "apa", "query": "studio", "listingType": "owner", "maxResultsPerSearch": 50, "includeDetails": True, "includeContactInfo": True, }, { "city": "detroit", "postalCode": "48201", "searchDistance": 20, "category": "zip", "maxResultsPerSearch": 50, }, ], "startUrls": [{ "url": "https://sfbay.craigslist.org/search/cta?query=honda%20civic&postal=94103&search_distance=25" }], "city": "newyork", "postalCode": "10001", "category": "apa", "query": "studio", } # Run the Actor and wait for it to finish run = client.actor("crowdpull/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 '{ "searches": [ { "city": "newyork", "postalCode": "10001", "searchDistance": 5, "category": "apa", "query": "studio", "listingType": "owner", "maxResultsPerSearch": 50, "includeDetails": true, "includeContactInfo": true }, { "city": "detroit", "postalCode": "48201", "searchDistance": 20, "category": "zip", "maxResultsPerSearch": 50 } ], "startUrls": [ { "url": "https://sfbay.craigslist.org/search/cta?query=honda%20civic&postal=94103&search_distance=25" } ], "city": "newyork", "postalCode": "10001", "category": "apa", "query": "studio" }' | apify call crowdpull/craigslist-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crowdpull/craigslist-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Craigslist Classifieds Scraper — No Login Required", "description": "Extract Craigslist listings across real estate, cars, jobs, gigs, services, for-sale, free stuff, community, and events. No login or cookies needed. Supports API-first search, postal-radius scoping, detail/contact enrichment, Smart Scrape, garage-sale dates, and real estate presets.", "version": "0.1", "x-build-id": "t5is4uXorUuA8BUPc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crowdpull~craigslist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crowdpull-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/crowdpull~craigslist-scraper/runs": { "post": { "operationId": "runs-sync-crowdpull-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/crowdpull~craigslist-scraper/run-sync": { "post": { "operationId": "run-sync-crowdpull-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": { "searches": { "title": "Searches", "type": "array", "description": "Run one or more Craigslist searches. Each search can override city, postal code, category, query, filters, and max results. Leave empty to use the top-level fields below.", "items": { "type": "object" } }, "startUrls": { "title": "Craigslist URLs", "type": "array", "description": "Optional Craigslist search/category/post URLs. Search URL filters are preserved when possible. Direct post URLs are hydrated as detail records.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL", "description": "Craigslist search, category, or posting URL." } } } }, "city": { "title": "City", "type": "string", "description": "Craigslist city subdomain such as newyork, sfbay, detroit, seattle, chicago, losangeles, or miami. A default postal code is used for popular cities; add postalCode for exact scoping.", "default": "newyork" }, "cities": { "title": "Cities", "type": "array", "description": "Optional list of Craigslist city subdomains. Each city runs the same top-level filters. Add postalCode inside searches[] for exact per-city scoping.", "items": { "type": "string" } }, "postalCode": { "title": "Postal Code", "type": "string", "description": "ZIP/postal code for accurate Craigslist API scoping. Recommended whenever geography matters." }, "searchDistance": { "title": "Search Distance", "minimum": 1, "maximum": 250, "type": "integer", "description": "Radius around the postal code in miles.", "default": 25 }, "category": { "title": "Category", "enum": [ "sss", "cta", "zip", "gms", "apa", "hhh", "rea", "roo", "sub", "vac", "off", "prk", "jjj", "ggg", "srv", "bbb", "ccc", "eee", "rrr" ], "type": "string", "description": "Craigslist category code. Real estate examples: apa apartments, hhh all housing, rea real estate for sale, roo rooms, sub sublets, vac vacation rentals, off office, prk parking. Broad examples: sss for sale, cta cars, gms garage sales, jjj jobs, ggg gigs, srv services, ccc community, eee events, zip free stuff.", "default": "apa" }, "categories": { "title": "Categories", "type": "array", "description": "Optional list of category codes to run with the same filters. Use this for all-housing or all-classifieds fanout.", "items": { "type": "string" } }, "query": { "title": "Search Query", "type": "string", "description": "Free-text Craigslist search query. Leave empty to browse the latest listings in the category." }, "minPrice": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum price in the local Craigslist currency." }, "maxPrice": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum price in the local Craigslist currency." }, "postedToday": { "title": "Posted Today", "type": "boolean", "description": "Only return listings Craigslist marks as posted in the last 24 hours.", "default": false }, "hasPic": { "title": "Has Image", "type": "boolean", "description": "Only return listings with at least one image.", "default": false }, "ownerOnly": { "title": "Owner Only", "type": "boolean", "description": "Compatibility toggle for owner/private posts. Prefer listingType for owner/dealer/all workflows.", "default": false }, "listingType": { "title": "Listing Type", "enum": [ "all", "owner", "dealer" ], "type": "string", "description": "Craigslist owner/dealer filter. Use owner for private-owner real-estate or vehicle searches, dealer for dealer listings, or all for no seller filter.", "default": "all" }, "hideDuplicates": { "title": "Hide Craigslist Duplicates", "type": "boolean", "description": "Ask Craigslist to bundle/hide duplicate postings when supported by the category.", "default": false }, "searchNearby": { "title": "Search Nearby Areas", "type": "boolean", "description": "Ask Craigslist to include nearby areas when supported by the search endpoint.", "default": false }, "deliveryAvailable": { "title": "Delivery Available", "type": "boolean", "description": "Only return listings marked with delivery available when Craigslist supports the filter.", "default": false }, "condition": { "title": "Condition", "type": "array", "description": "Optional Craigslist condition filters. Use values like new, like-new, excellent, good, fair, salvage, or numeric Craigslist codes 10/20/30/40/50/60.", "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "date", "dateoldest", "rel", "priceasc", "pricedsc", "dist" ], "type": "string", "description": "Craigslist sort order.", "default": "date" }, "minBedrooms": { "title": "Minimum Bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms for housing categories." }, "maxBedrooms": { "title": "Maximum Bedrooms", "minimum": 0, "type": "integer", "description": "Maximum number of bedrooms for housing categories." }, "minBathrooms": { "title": "Minimum Bathrooms", "minimum": 0, "type": "number", "description": "Minimum number of bathrooms for housing categories." }, "maxBathrooms": { "title": "Maximum Bathrooms", "minimum": 0, "type": "number", "description": "Maximum number of bathrooms for housing categories." }, "minSqft": { "title": "Minimum Square Feet", "minimum": 0, "type": "integer", "description": "Minimum square footage for housing categories." }, "maxSqft": { "title": "Maximum Square Feet", "minimum": 0, "type": "integer", "description": "Maximum square footage for housing categories." }, "catsOk": { "title": "Cats OK", "type": "boolean", "description": "Only include housing listings that allow cats when Craigslist supports the filter.", "default": false }, "dogsOk": { "title": "Dogs OK", "type": "boolean", "description": "Only include housing listings that allow dogs when Craigslist supports the filter.", "default": false }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Only include furnished housing listings when Craigslist supports the filter.", "default": false }, "startDate": { "title": "Start Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Garage-sale date filter start, formatted as YYYY-MM-DD." }, "endDate": { "title": "End Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Garage-sale date filter end, formatted as YYYY-MM-DD. Date ranges are capped at 31 days." }, "includeDetails": { "title": "Include Details", "type": "boolean", "description": "Fetch each posting page for full description, attribute text, and richer images. Search-card mode is faster and cheaper.", "default": false }, "includeContactInfo": { "title": "Include Contact Info", "type": "boolean", "description": "Fetch each public posting page and extract visible phone/email text, mailto/tel links, and Craigslist reply URL metadata when exposed.", "default": false }, "onlyNew": { "title": "Only New or Changed", "type": "boolean", "description": "Use a named key-value store cache to emit only listings that are new or materially changed since a previous run.", "default": false }, "cacheName": { "title": "Smart Scrape Cache Name", "type": "string", "description": "Named key-value store used by onlyNew. Keep the same value for scheduled monitor runs.", "default": "craigslist-scraper-cache" }, "maxResultsPerSearch": { "title": "Max Results Per Search", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Maximum listings to save per normalized search. Craigslist API batches are fetched in 360-item pages.", "default": 100 }, "maxConcurrency": { "title": "Max Detail Concurrency", "minimum": 1, "maximum": 16, "type": "integer", "description": "Maximum concurrent detail-page fetches when includeDetails or includeContactInfo is enabled.", "default": 4 }, "requestDelayMs": { "title": "Request Delay Milliseconds", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between Craigslist search API batch requests.", "default": 250 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 1, "maximum": 8, "type": "integer", "description": "Retry attempts for transient Craigslist API/detail failures.", "default": 3 }, "saveDebugHtml": { "title": "Save Debug HTML", "type": "boolean", "description": "Save failed detail-page HTML/error snippets to the default key-value store.", "default": false } } }, "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 } } } } } } } } } } ```