{ "openapi": "3.0.1", "info": { "title": "Craigslist Listing Monitor — New Posts Alerts, No Login, $10/1k", "description": "Watch Craigslist searches (housing, cars, jobs, gigs, for sale) across cities and get only NEW listings since the last run, with price, location, coordinates, images and optional full details. Schedule it every 30 minutes. No login. MCP-ready. $10 per 1,000 alerts.", "version": "1.0", "x-build-id": "vemfJvjkdoEUNjEuN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/outstanding_vegetable~craigslist-listing-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-outstanding_vegetable-craigslist-listing-monitor", "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/outstanding_vegetable~craigslist-listing-monitor/runs": { "post": { "operationId": "runs-sync-outstanding_vegetable-craigslist-listing-monitor", "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/outstanding_vegetable~craigslist-listing-monitor/run-sync": { "post": { "operationId": "run-sync-outstanding_vegetable-craigslist-listing-monitor", "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": "Saved searches", "type": "array", "description": "One object per saved search: city (Craigslist area code from the URL: sfbay, newyork, losangeles, chicago, austin, seattle…), category (apa apartments, hhh all housing, roo rooms, cta cars & trucks, mca motorcycles, sss all for sale, fua furniture, ela electronics, jjj all jobs, ggg gigs, bbb services…), optional query, minPrice, maxPrice, postedToday (true = only today's posts), label (name used in searchLabel) and filters (extra Craigslist URL params such as {\"min_bedrooms\": 2, \"hasPic\": 1, \"auto_transmission\": 2}).", "default": [ { "city": "sfbay", "category": "apa", "query": "", "minPrice": 1500, "maxPrice": 3500, "postedToday": true }, { "city": "austin", "category": "cta", "query": "toyota tacoma" } ] }, "maxNewPerSearch": { "title": "Max new listings per search", "minimum": 1, "maximum": 360, "type": "integer", "description": "Stop emitting after this many new listings for one search. Listings beyond the cap stay unseen and are emitted on the next run (except on the very first run, where the rest is recorded as seen).", "default": 5 }, "maxItems": { "title": "Max new listings per run", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Total cap across all searches for one run.", "default": 10 }, "includeDetails": { "title": "Fetch posting details", "type": "boolean", "description": "Open each new posting for the full body text, attributes (bedrooms, sqft, make, model, condition…), all images, street address, map coordinates and the posted time. One extra request per new listing.", "default": false }, "firstRunMode": { "title": "First run mode", "enum": [ "emitAll", "baseline" ], "type": "string", "description": "What to do when the monitor has no saved state yet. emitAll: emit the newest current listings (up to the caps) and record the rest as seen. baseline: silently record every current listing as seen and emit nothing, so the next scheduled run reports only what is new since.", "default": "emitAll" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. After each run a JSON summary {monitorId, runAt, newCount, searches[], listings[first 50]} is POSTed here (Slack/Zapier/Make/your API), also when newCount is 0 so you get a heartbeat per run.", "default": "" }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of this watchlist. Each monitor ID keeps its own seen-state in a key-value store named craigslist-monitor-, so you can run several profiles side by side.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential US proxy recommended; Craigslist blocks most shared datacenter ranges after a few requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }