# Craigslist Scraper - Multi-City (`webdata_labs/craigslist-scraper`) Actor \[๐Ÿ’ต $1.90 / 1K] Scrape Craigslist listings from any city and category in one run. Multi-city, price/ZIP/radius filters, duplicate removal, plus optional descriptions, attributes, coordinates and images. Or just paste a search URL. - **URL**: https://apify.com/webdata\_labs/craigslist-scraper.md - **Developed by:** [WebData Labs](https://apify.com/webdata_labs) (community) - **Categories:** E-commerce, Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 75.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.10 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Craigslist Scraper - any city, any Category **Scrape Craigslist listings into a clean spreadsheet. Many cities in one run, every filter Craigslist has, and pagination that does not stop at page one.** Give it a keyword and a city - or just paste a Craigslist search URL - and get back every listing with title, price, location, coordinates, photos, posting date and a working link. Turn on **Include full listing details** and each row also carries the full description, the seller's attributes (condition, make, model, bedrooms, mileage...) and exact coordinates. ### โœ… What you get / โŒ what this isn't | โœ… This Actor gives you | โŒ This Actor is not | |---|---| | **Many cities in one run** - list 1 or 50 | Not one run per city | | **Thousands of listings per search** - it pages past Craigslist's ~360 page cap | Not the first page only | | Every Craigslist filter: price, ZIP + radius, photos-only, title-only, nearby areas | Not keyword-only search | | Duplicate reposts removed by default | Not a raw dump of the same ad 12 times | | Full descriptions, attributes, coordinates and all photos on demand | Not private seller contact details | | Paste any Craigslist search URL and it just works | Not a puzzle of undocumented city codes | ### ๐Ÿ”Ž Why this one - **No 360-result ceiling.** Craigslist's own search page stops after a few hundred results. This Actor speaks Craigslist's internal pagination protocol and keeps going - 1,000, 5,000, as many as the search has. - **Multi-city.** `["newyork", "sfbay", "chicago"]` in one run instead of three runs you stitch together yourself. - **City names that make sense.** `newyork`, `New York`, `sfbay`, `SF bay area`, even a pasted `losangeles.craigslist.org` all resolve. 700+ Craigslist regions worldwide. - **Paste-a-URL mode.** Built the perfect search in your browser? Paste the URL into `startUrls` - every filter in it is honoured. - **Duplicates gone.** The same ad reposted under new IDs is collapsed automatically. - **Category-aware fields.** Cars get `odometer`, apartments get `bedrooms` and `sqft`, jobs get `compensation` and `employer` - without you asking. - **Fast and cheap.** Pure HTTP, no browser. A thousand listings takes well under a minute. ### ๐Ÿ‘ฅ Who it's for - **Resellers and flippers** watching for underpriced inventory across several metros at once. - **Real-estate and rental analysts** pulling apartment inventory with beds, sqft and price. - **Car dealers and buyers** tracking local vehicle pricing with mileage. - **Recruiters** monitoring job and gig postings by city. - **Researchers** building local-market datasets. ### โš™๏ธ How to scrape Craigslist 1. Open the Actor on Apify. 2. Type your **search terms**, e.g. `mountain bike`. 3. Add one or more **cities**, e.g. `newyork` and `sfbay`. 4. Pick a **category** (or leave it on *All for sale*). 5. Set **Max listings** - the budget for the whole run, split evenly across your searches. 6. Optional: turn on **Include full listing details**, set a price range, a ZIP + radius, or photos-only. 7. Click **Start**, then download the results as CSV, JSON or Excel. Prefer a URL? Skip steps 2-6 and paste your Craigslist search URL into **Craigslist search URLs**. ### ๐Ÿ“ฅ Input ```json { "searchTerms": ["mountain bike"], "cities": ["newyork", "sfbay"], "category": "bicycles", "maxItems": 500, "minPrice": 100, "maxPrice": 800, "hasImage": true, "includeDetails": true, "sortBy": "newest" } ```` | Field | Meaning | |---|---| | `searchTerms` | Keywords. Leave empty to browse a whole category. | | `cities` | One or more Craigslist regions. `newyork`, `New York` and `nyc` all work. | | `category` | Section to search: all for sale, housing, jobs, cars, apartments, gigs... | | `maxItems` | Listings for the whole run, split across your searches. | | `includeDetails` | Open every posting for description, attributes, exact coordinates, all photos. | | `startUrls` | Paste Craigslist search URLs; their filters are honoured as-is. | | `minPrice` / `maxPrice` | Price range. | | `postedWithinDays` | Keep only listings from the last N days. | | `hasImage` | Only listings with photos. | | `titleOnly` | Match the keyword against the title only - far less noise. | | `searchNearbyAreas` | Include neighbouring Craigslist regions. | | `postalCode` + `searchRadiusMiles` | Search around a ZIP code. | | `sortBy` | Newest, best match, price lowโ†’high, price highโ†’low. | | `deduplicate` | Collapse the same ad reposted under new IDs. On by default. | | `imageSize` | Thumbnail, small, medium or large image URLs. | | `proxyConfiguration` | Apify Proxy. Recommended - Craigslist rate-limits by IP. | ### ๐Ÿ“ค Output One row per listing: | title | price | location | city | category | postedAt | imageCount | url | |---|---|---|---|---|---|---|---| | Trek 800 mountain track bicycle | 120 | brooklyn | newyork | bicycles - by owner | 2026-07-25T13:54:46Z | 3 | [link](https://newyork.craigslist.org/) | **Always present:** `postingId`, `title`, `price`, `priceText`, `location`, `city`, `category`, `categoryCode`, `url`, `postedAt`, `latitude`, `longitude`, `imageCount`, `imageUrls`, `thumbnailUrl`, `postingHash`, `searchTerm`, `totalResultsAvailable`, `scrapedAt`. **By category, when Craigslist provides it:** `bedrooms`, `sqft` (housing) ยท `odometer` (vehicles) ยท `compensation`, `employer`, `jobTitle` (jobs). **With `includeDetails`:** `description`, `attributes` (every seller-filled field), `condition`, `make`, `model`, `address`, precise `latitude`/`longitude`, `mapAccuracy`, `originalPostedAt`, `updatedAt`, full-resolution `imageUrls`, `isActive`.
Sample row (with details on) ```json { "postingId": 7941528365, "title": "Trek 800 mountain track bicycle nice bike $120", "price": 120, "priceText": "$120", "location": "brooklyn", "city": "newyork", "category": "bicycles - by owner", "url": "https://newyork.craigslist.org/bik/d/brooklyn-trek-800-mountain-track/7941528365.html", "postedAt": "2026-07-25T13:54:46Z", "latitude": 40.610653, "longitude": -73.953544, "imageCount": 3, "imageUrls": ["https://images.craigslist.org/00v0v_gzsOLs7OU3w_0x20oM_600x450.jpg"], "description": "Trek 800 mountain track bicycle nice bike", "attributes": { "condition": "excellent" }, "condition": "excellent", "address": "Ocean Avenue near Kings Highway", "originalPostedAt": "2026-06-17T10:36:29-0400", "updatedAt": "2026-07-25T09:49:46-0400", "isActive": true } ```
#### Quick preview | Input | Output | |---|---| | `mountain bike` in `newyork` + `sfbay`, photos only, $100-$800 | ~40 bikes across both metros with prices, photos and map coordinates | | `category: apartments`, `postalCode: 10001`, radius 5 mi | Manhattan rentals with `bedrooms`, `sqft` and price | | Pasted URL `sfbay.craigslist.org/search/cta?query=tacoma&max_price=20000` | Trucks under $20k with `odometer` on every row | ### ๐Ÿ’ต How much does it cost? **$1.90 per 1,000 listings. No start fee** - a run that returns nothing costs you nothing. Because it runs on plain HTTP instead of a browser, a 1,000-listing run finishes in well under a minute. `includeDetails` adds one request per listing; it is slower, but the price per listing does not change. ### ๐Ÿš€ Ready-made setups Five ready-to-run tasks ship with this Actor - open one, hit Start, or copy it and swap in your own cities: | Task | What it does | |---|---| | [Find Craigslist cars and trucks under $10,000](https://apify.com/webdata_labs/craigslist-scraper/examples/craigslist-cars-and-trucks-under-10k) | Cars & trucks under $10k across New York, Los Angeles and Chicago, with mileage and condition on every row. | | [Scrape Craigslist apartments for rent near a ZIP code](https://apify.com/webdata_labs/craigslist-scraper/examples/craigslist-apartments-for-rent-near-zip) | Rentals within 10 miles of ZIP 10001 under $4,000, with bedrooms, sqft and full descriptions. | | [Monitor Craigslist free stuff posted today](https://apify.com/webdata_labs/craigslist-scraper/examples/craigslist-free-stuff-posted-today) | Everything listed free today in the SF Bay Area, Los Angeles and Seattle - photos only. | | [Find underpriced Craigslist furniture to flip](https://apify.com/webdata_labs/craigslist-scraper/examples/craigslist-furniture-deals-to-flip) | Mid-century, solid wood and Herman Miller pieces under $300 in Chicago and Boston. | | [Scrape Craigslist job postings across several cities](https://apify.com/webdata_labs/craigslist-scraper/examples/craigslist-job-postings-by-city) | Jobs posted in the last week in New York, Austin and Denver, with pay and employer. | ### ๐Ÿ” Run it on the Apify platform Schedule it to sweep your cities every morning, call it from the Apify API, export to CSV/JSON/Excel, or wire it into Make, Zapier, Google Sheets or a webhook so new listings land wherever you work. ### โš ๏ธ Limits and caveats - Reads only **public** Craigslist listings. It does not log in, and it does not collect seller emails or phone numbers. - Craigslist blocks an IP after a burst of requests. The Actor rotates its proxy exit IP per search and part-way through detail fetching, so keep Apify Proxy on (it is by default) - turning it off will cut multi-city runs short. - `postedAt` is the date Craigslist shows in search results - for renewed ads that is the renewal date. With `includeDetails` you also get `originalPostedAt` and `updatedAt`. - Craigslist caps any single search at a few thousand results. For very broad searches, split by category, city or price band. - Fields such as `bedrooms` or `odometer` exist only where the seller filled them in. ### ๐Ÿงฉ Related Actors - **Google Maps Business Scraper** - local business data for the same metros. - **Lead List Deduplicator & Normalizer** - clean and merge the lists you build. ### โ“ FAQ **Can I scrape more than one city per run?** Yes. List as many as you like in `cities`; results are tagged with the city they came from. **Can I get more than the ~360 results Craigslist shows?** Yes - that is the main reason this Actor exists. Set `maxItems` higher and it pages through the full result set. **Do I need to know Craigslist's city codes?** No. Type the city the way you say it. **Can I reuse a search I built in my browser?** Yes - paste the URL into `startUrls`. **Does it collect personal data?** No. Public listing content only, no contact details. **Why are some fields empty?** Craigslist listings are free-form. A field appears only when the seller filled it in and, for descriptions and attributes, when `includeDetails` is on. ### ๐Ÿ› ๏ธ Support If a run fails or a field looks wrong, open an Actor issue with the run URL, the input you used, and what you expected. Craigslist changes its layout occasionally - reports get fixed quickly. ### โญ Rate this Actor If this Actor saved you time, please take 30 seconds to leave a review on the **Reviews** tab - reviews are the main trust signal other users see, and they decide which features get built next. If something is broken, please open an issue first: we typically respond within a day and would love the chance to fix it before you rate. # Actor input Schema ## `searchTerms` (type: `array`): Keywords to search for. Leave empty to browse a whole category. Each term is searched in every city you list. ## `cities` (type: `array`): One or more Craigslist cities. Type them however you like - 'newyork', 'New York', 'sfbay' and 'SF bay area' all work. Add as many as you want; the competition makes you run once per city. ## `category` (type: `string`): Which Craigslist section to search. ## `maxItems` (type: `integer`): Total listings for the whole run, split evenly across your searches. Craigslist search pages stop at ~360 results - this Actor pages past that and can pull thousands. ## `includeDetails` (type: `boolean`): Open each posting to add the full description, seller attributes (condition, make, model, bedrooms, mileage...), exact coordinates and every image. Slower, but much richer. ## `startUrls` (type: `array`): Paste search URLs straight from your browser - all filters in the URL are honoured. Use this instead of the fields above when you already have a search you like. ## `minPrice` (type: `integer`): Lowest price to include. Leave empty for no minimum. ## `maxPrice` (type: `integer`): Highest price to include. Leave empty for no maximum. ## `postedWithinDays` (type: `integer`): Keep only listings posted in the last N days. Leave empty to keep everything. ## `hasImage` (type: `boolean`): Skip listings without photos. Useful when you need images for resale or review. ## `titleOnly` (type: `boolean`): Match the search term against the title instead of the whole posting. Cuts a lot of noise. ## `searchNearbyAreas` (type: `boolean`): Also return results from Craigslist regions neighbouring each city. ## `postalCode` (type: `string`): Centre the search on a ZIP code. Combine with the search radius below. ## `searchRadiusMiles` (type: `integer`): Only used together with a ZIP code. ## `sortBy` (type: `string`): Order Craigslist returns results in. 'Newest first' is best for monitoring; price sorts are best for deal hunting. ## `deduplicate` (type: `boolean`): Craigslist is full of the same ad reposted under new IDs. On by default: identical title + price + location is kept once. ## `bundleDuplicates` (type: `boolean`): Ask Craigslist itself to collapse repeat postings before they reach you. ## `imageSize` (type: `string`): Resolution of the image URLs in the output. Larger sizes are the same photos at higher resolution. ## `maxRequestRetries` (type: `integer`): Retries per request before a search is recorded as failed. ## `proxyConfiguration` (type: `object`): Craigslist rate-limits by IP. Datacenter proxies are enough for most runs; switch to residential if you scrape very large volumes. ## Actor input object example ```json { "searchTerms": [ "mountain bike" ], "cities": [ "newyork" ], "category": "all", "maxItems": 200, "includeDetails": false, "startUrls": [], "hasImage": false, "titleOnly": false, "searchNearbyAreas": false, "sortBy": "newest", "deduplicate": true, "bundleDuplicates": false, "imageSize": "medium", "maxRequestRetries": 4, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (type: `string`): No description ## `details` (type: `string`): No description ## `results` (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 = { "searchTerms": [ "mountain bike" ], "cities": [ "newyork" ], "startUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("webdata_labs/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 = { "searchTerms": ["mountain bike"], "cities": ["newyork"], "startUrls": [], } # Run the Actor and wait for it to finish run = client.actor("webdata_labs/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 '{ "searchTerms": [ "mountain bike" ], "cities": [ "newyork" ], "startUrls": [] }' | apify call webdata_labs/craigslist-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=webdata_labs/craigslist-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Craigslist Scraper - Multi-City", "description": "[๐Ÿ’ต $1.90 / 1K] Scrape Craigslist listings from any city and category in one run. Multi-city, price/ZIP/radius filters, duplicate removal, plus optional descriptions, attributes, coordinates and images. Or just paste a search URL.", "version": "0.1", "x-build-id": "PBNbM8dGc1HgoLKIK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~craigslist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-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/webdata_labs~craigslist-scraper/runs": { "post": { "operationId": "runs-sync-webdata_labs-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/webdata_labs~craigslist-scraper/run-sync": { "post": { "operationId": "run-sync-webdata_labs-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search for. Leave empty to browse a whole category. Each term is searched in every city you list.", "default": [ "mountain bike" ], "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "One or more Craigslist cities. Type them however you like - 'newyork', 'New York', 'sfbay' and 'SF bay area' all work. Add as many as you want; the competition makes you run once per city.", "default": [ "newyork" ], "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "forSale", "housing", "apartments", "jobs", "gigs", "services", "community", "resumes", "carsAndTrucks", "motorcycles", "rvsAndCampers", "boats", "bicycles", "furniture", "electronics", "computers", "tools", "generalForSale", "freeStuff" ], "type": "string", "description": "Which Craigslist section to search.", "default": "all" }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total listings for the whole run, split evenly across your searches. Craigslist search pages stop at ~360 results - this Actor pages past that and can pull thousands.", "default": 200 }, "includeDetails": { "title": "Include full listing details", "type": "boolean", "description": "Open each posting to add the full description, seller attributes (condition, make, model, bedrooms, mileage...), exact coordinates and every image. Slower, but much richer.", "default": false }, "startUrls": { "title": "Craigslist search URLs (optional)", "type": "array", "description": "Paste search URLs straight from your browser - all filters in the URL are honoured. Use this instead of the fields above when you already have a search you like.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Lowest price to include. Leave empty for no minimum." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Highest price to include. Leave empty for no maximum." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Keep only listings posted in the last N days. Leave empty to keep everything." }, "hasImage": { "title": "Only listings with photos", "type": "boolean", "description": "Skip listings without photos. Useful when you need images for resale or review.", "default": false }, "titleOnly": { "title": "Search titles only", "type": "boolean", "description": "Match the search term against the title instead of the whole posting. Cuts a lot of noise.", "default": false }, "searchNearbyAreas": { "title": "Include nearby areas", "type": "boolean", "description": "Also return results from Craigslist regions neighbouring each city.", "default": false }, "postalCode": { "title": "ZIP / postal code", "type": "string", "description": "Centre the search on a ZIP code. Combine with the search radius below." }, "searchRadiusMiles": { "title": "Search radius (miles)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Only used together with a ZIP code." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance", "priceAsc", "priceDesc" ], "type": "string", "description": "Order Craigslist returns results in. 'Newest first' is best for monitoring; price sorts are best for deal hunting.", "default": "newest" }, "deduplicate": { "title": "Remove duplicate postings", "type": "boolean", "description": "Craigslist is full of the same ad reposted under new IDs. On by default: identical title + price + location is kept once.", "default": true }, "bundleDuplicates": { "title": "Let Craigslist bundle duplicates too", "type": "boolean", "description": "Ask Craigslist itself to collapse repeat postings before they reach you.", "default": false }, "imageSize": { "title": "Image size", "enum": [ "thumb", "small", "medium", "large" ], "type": "string", "description": "Resolution of the image URLs in the output. Larger sizes are the same photos at higher resolution.", "default": "medium" }, "maxRequestRetries": { "title": "Max request retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Retries per request before a search is recorded as failed.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Craigslist rate-limits by IP. Datacenter proxies are enough for most runs; switch to residential if you scrape very large volumes.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```