{ "openapi": "3.0.1", "info": { "title": "Craigslist Scraper - $0.85 per 1,000, No API Key", "description": "A flat $0.85 per 1,000 listings plus $0.002 per run. Search any Craigslist city and category and get listing id, title, price, neighborhood, posted date, images and the listing URL. No account, no API key, no captcha wrangling. Blocked or empty runs are never charged.", "version": "0.1", "x-build-id": "Wa98Pn6XywwLfpY4B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~craigslist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~craigslist-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~craigslist-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "city": { "title": "City", "type": "array", "description": "Craigslist city (the subdomain), e.g. \"newyork\", \"sfbay\", \"losangeles\", \"london\". Plain city names like \"new york city\" also work. Add several to search several cities in one run. 707 Craigslist sites in 79 countries are recognised.", "items": { "type": "string" } }, "query": { "title": "Search terms", "type": "string", "description": "What to search for, e.g. \"mountain bike\". Leave empty to return everything in the category." }, "category": { "title": "Category", "type": "string", "description": "Craigslist category abbreviation. Groups: sss = all for sale, hhh = housing, jjj = jobs, ggg = gigs, bbb = services, ccc = community, cta = cars & trucks, eee = events. Leaf categories work too: bia bicycles, apa apartments, fuo furniture, zip free stuff, ela electronics.", "default": "sss" }, "searchUrls": { "title": "Craigslist search URLs", "type": "array", "description": "Optional. Paste full Craigslist search URLs instead of filling in the fields above, e.g. https://newyork.craigslist.org/search/bia?query=trek. Filters already in the URL are kept.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many listings to return in total across all searches (1-50000). Each returned listing is one charged result.", "default": 100 }, "fetchDetails": { "title": "Fetch full posting text", "type": "boolean", "description": "Open each posting page to add the seller's body text, the attribute table (condition, make, bedrooms, ...), the street address when shown, and the last-updated time. Slower: roughly one extra request per listing.", "default": false }, "sort": { "title": "Sort", "enum": [ "newest", "relevant" ], "type": "string", "description": "Newest first is the only order that can return more than 360 listings - Craigslist caps relevance-ordered results at 360. Price sorting is not offered by Craigslist's API.", "default": "newest" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Optional lower price bound." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Optional upper price bound." }, "postalCode": { "title": "ZIP / postal code", "type": "string", "description": "Optional. Search around this postal code instead of the whole city. Use together with the radius below." }, "radiusMiles": { "title": "Radius (miles)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Optional. Only used when a postal code is set." }, "sellerType": { "title": "Posted by", "enum": [ "any", "owner", "dealer" ], "type": "string", "description": "Restrict to owner or dealer postings. Only meaningful in categories that have both.", "default": "any" }, "hasImage": { "title": "Only listings with photos", "type": "boolean", "description": "Skip postings that have no images.", "default": false }, "titleOnly": { "title": "Search titles only", "type": "boolean", "description": "Match the search terms against listing titles instead of the whole posting.", "default": false }, "postedToday": { "title": "Posted today only", "type": "boolean", "description": "Restrict to postings from today.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave as-is unless you need a specific egress. Residential proxy is not required." } } }, "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 } } } } } } } } } }