{ "openapi": "3.0.1", "info": { "title": "Craigslist Scraper - Listings, Prices & Photos, No Login", "description": "Scrape Craigslist listings from any of 700+ cities by category, keyword and price: title, price, location, coordinates, photos and post date, plus full description and attributes on request. Only-new mode for monitoring. No login, proxy or seller contacts.", "version": "0.1", "x-build-id": "oCVqAOZFlci4os9uF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~craigslist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-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/cliqtomedia~craigslist-scraper/runs": { "post": { "operationId": "runs-sync-cliqtomedia-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/cliqtomedia~craigslist-scraper/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-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", "required": [ "cities" ], "properties": { "cities": { "title": "Cities", "minItems": 1, "maxItems": 50, "type": "array", "description": "Craigslist sites to search: the subdomain from the city address, e.g. \"sfbay\" for sfbay.craigslist.org, \"newyork\", \"losangeles\", \"london\", \"toronto\". Full addresses work too. Any of the 700+ Craigslist sites, up to 50 per run.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "sss", "ata", "ppa", "ara", "sna", "pta", "wta", "ava", "baa", "bar", "bip", "bia", "bpa", "boa", "bka", "bfa", "cta", "ema", "moa", "cla", "cba", "syp", "sya", "ela", "gra", "zip", "fua", "gms", "foa", "haa", "hva", "hsa", "jwa", "maa", "mpa", "mca", "msa", "pha", "rva", "sga", "tia", "tla", "taa", "tra", "vga", "waa", "hhh", "apa", "rea", "roo", "sub", "vac", "off", "prk", "swp", "jjj", "ggg", "bbb", "ccc", "eee", "rrr" ], "type": "string", "description": "Craigslist section to search. \"— all\" entries cover the whole group.", "default": "sss" }, "query": { "title": "Search keywords", "maxLength": 200, "type": "string", "description": "Words as you would type them in the Craigslist search box, e.g. \"road bike\" or \"iphone 15\". Leave empty to list the whole category." }, "maxItems": { "title": "Max listings per city", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit of listings saved for each city, newest first. Craigslist itself lists at most 10,000 per search.", "default": 100 }, "includeDetails": { "title": "Include full listing details", "type": "boolean", "description": "Also open each listing page for the full description, attributes (condition, make, odometer, bedrooms…), all photos and ZIP code. Slower and charged as a detailed listing. Phone numbers and e-mails in the text are always masked.", "default": false }, "onlyNew": { "title": "Only new listings since last run", "type": "boolean", "description": "Saves (and charges) only listings posted or renewed after the previous run of the same search. The first run saves the newest listings up to the limit and sets the starting point. Use it with a schedule to monitor a search.", "default": false }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this, in the local currency of the site." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this, in the local currency of the site." }, "sellerType": { "title": "Seller type", "enum": [ "all", "owner", "dealer" ], "type": "string", "description": "All sellers, owners only or dealers only (for-sale categories).", "default": "all" }, "hasImages": { "title": "Only listings with photos", "type": "boolean", "description": "Skip listings without pictures.", "default": false }, "postedToday": { "title": "Only posted today", "type": "boolean", "description": "Only listings posted today.", "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 }, "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 } } } } } } } } } }