{
  "openapi": "3.0.1",
  "info": {
    "title": "Craigslist Scraper - Listings, Prices, Photos & Contacts",
    "description": "Scrape craigslist listings from any city, category and keyword: title, price, location with GPS, posting body, attributes (year, odometer, VIN, beds, baths, salary), every photo, posted/updated dates, and phones or emails written in the posting. Monitor mode returns only new postings.",
    "version": "0.1",
    "x-build-id": "dWRgDDXsSqjh7aJ0E"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~craigslist-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-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/scrapersdelight~craigslist-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-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/scrapersdelight~craigslist-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-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": {
          "startUrls": {
            "title": "Craigslist URLs",
            "type": "array",
            "description": "Search pages or single postings, old or new link style, e.g. \"https://sfbay.craigslist.org/search/sss?query=bike\", \"https://www.craigslist.org/search/area/newyork?cat=cta\", a posting link. A pasted search keeps its own filters.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "One search per keyword, e.g. \"honda civic\", \"standing desk\". craigslist needs every word to appear, so keep it short. Empty = every posting in the category.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Cities",
            "type": "array",
            "description": "craigslist city sites: the subdomain (\"sfbay\", \"newyork\", \"toronto\", \"london\"), a craigslist link, or a preset: \"all-us\", \"all-ca\", \"all-gb\", \"all\". Empty (and no URLs) = SF bay area.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category",
            "enum": [
              "sss",
              "ata",
              "ppa",
              "ara",
              "sna",
              "pta",
              "ava",
              "baa",
              "bar",
              "haa",
              "bip",
              "bia",
              "bpa",
              "boo",
              "bka",
              "bfa",
              "cta",
              "ema",
              "moa",
              "cla",
              "cba",
              "syp",
              "sya",
              "ela",
              "gra",
              "zip",
              "fua",
              "gms",
              "foa",
              "hva",
              "hsa",
              "jwa",
              "maa",
              "mpa",
              "mca",
              "msa",
              "pha",
              "rva",
              "sga",
              "tia",
              "tla",
              "taa",
              "tra",
              "vga",
              "waa",
              "wta",
              "hhh",
              "apa",
              "swp",
              "hsw",
              "off",
              "prk",
              "rea",
              "roo",
              "sha",
              "sub",
              "vac",
              "jjj",
              "acc",
              "ofc",
              "egr",
              "med",
              "sci",
              "bus",
              "csr",
              "edu",
              "etc",
              "fbh",
              "lab",
              "gov",
              "hum",
              "lgl",
              "mnu",
              "mar",
              "hea",
              "npo",
              "rej",
              "ret",
              "sls",
              "spa",
              "sec",
              "trd",
              "sof",
              "sad",
              "tch",
              "trp",
              "tfr",
              "web",
              "wri",
              "ggg",
              "cpg",
              "crg",
              "cwg",
              "dmg",
              "evg",
              "lbg",
              "tlg",
              "wrg",
              "bbb",
              "aos",
              "bts",
              "cms",
              "cps",
              "crs",
              "cys",
              "evs",
              "fgs",
              "fns",
              "hws",
              "hss",
              "lbs",
              "lgs",
              "lss",
              "mas",
              "pas",
              "rts",
              "sks",
              "biz",
              "trv",
              "wet",
              "ccc",
              "act",
              "ats",
              "kid",
              "cls",
              "eve",
              "com",
              "grp",
              "vnn",
              "laf",
              "mis",
              "muc",
              "pet",
              "pol",
              "rnr",
              "rid",
              "vol",
              "eee",
              "rrr"
            ],
            "type": "string",
            "description": "craigslist section to search. \"All for sale\" covers every for-sale category; a narrower one (cars+trucks, apts / housing, jobs...) uses craigslist's own category filter.",
            "default": "sss"
          },
          "categoryCode": {
            "title": "Category code (overrides)",
            "type": "string",
            "description": "Any craigslist category code, e.g. \"cto\" (cars by owner), \"ctd\" (cars by dealer), \"bik\". Overrides the dropdown when filled.",
            "default": ""
          },
          "subarea": {
            "title": "Sub-area",
            "type": "string",
            "description": "A craigslist sub-area code inside the city, e.g. \"brk\" (Brooklyn), \"mnh\" (Manhattan), \"eby\" (East Bay). Empty = the whole city.",
            "default": ""
          },
          "postalCode": {
            "title": "ZIP / postal code",
            "type": "string",
            "description": "Search around this ZIP or postal code (craigslist picks the city from it), e.g. \"10001\". Use with Search distance.",
            "default": ""
          },
          "searchDistance": {
            "title": "Search distance (miles)",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Radius around the ZIP / postal code. 0 = craigslist's default.",
            "default": 0
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Only postings priced at or above this, in the city's currency. craigslist ignores it where postings have no price (jobs, community)."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Only postings priced at or below this, in the city's currency."
          },
          "freeOnly": {
            "title": "Free items only",
            "type": "boolean",
            "description": "Only postings marked free (for-sale categories).",
            "default": false
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "all",
              "owner",
              "dealer"
            ],
            "type": "string",
            "description": "craigslist's own 'sold by' filter.",
            "default": "all"
          },
          "condition": {
            "title": "Condition",
            "type": "array",
            "description": "Item condition (for-sale categories). Postings without a condition drop out when this is set.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "like-new",
                "excellent",
                "good",
                "fair",
                "salvage"
              ],
              "enumTitles": [
                "new",
                "like new",
                "excellent",
                "good",
                "fair",
                "salvage"
              ]
            },
            "default": []
          },
          "hasImage": {
            "title": "Has image",
            "type": "boolean",
            "description": "Only postings with at least one photo.",
            "default": false
          },
          "postedToday": {
            "title": "Posted today",
            "type": "boolean",
            "description": "Only postings from the last 24 hours (craigslist's own filter).",
            "default": false
          },
          "searchTitlesOnly": {
            "title": "Search titles only",
            "type": "boolean",
            "description": "Match keywords against titles only, not the posting body.",
            "default": false
          },
          "hideDuplicates": {
            "title": "Hide duplicates",
            "type": "boolean",
            "description": "Let craigslist bundle near-identical reposts into one result.",
            "default": false
          },
          "deliveryAvailable": {
            "title": "Delivery available",
            "type": "boolean",
            "description": "Only for-sale postings where the seller offers delivery.",
            "default": false
          },
          "minBedrooms": {
            "title": "Min bedrooms",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Housing only."
          },
          "maxBedrooms": {
            "title": "Max bedrooms",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Housing only."
          },
          "minBathrooms": {
            "title": "Min bathrooms",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Housing only."
          },
          "maxBathrooms": {
            "title": "Max bathrooms",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Housing only."
          },
          "minSqft": {
            "title": "Min square feet",
            "minimum": 0,
            "type": "integer",
            "description": "Housing only (square feet as the poster entered them)."
          },
          "maxSqft": {
            "title": "Max square feet",
            "minimum": 0,
            "type": "integer",
            "description": "Housing only."
          },
          "catsOk": {
            "title": "Cats OK",
            "type": "boolean",
            "description": "Housing: only postings that allow cats.",
            "default": false
          },
          "dogsOk": {
            "title": "Dogs OK",
            "type": "boolean",
            "description": "Housing: only postings that allow dogs.",
            "default": false
          },
          "makeModel": {
            "title": "Make and model",
            "type": "string",
            "description": "Vehicles: craigslist's make/model filter, e.g. \"toyota tacoma\".",
            "default": ""
          },
          "minYear": {
            "title": "Min model year",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Vehicles only."
          },
          "maxYear": {
            "title": "Max model year",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Vehicles only."
          },
          "minOdometer": {
            "title": "Min odometer",
            "minimum": 0,
            "type": "integer",
            "description": "Vehicles only (miles as posted)."
          },
          "maxOdometer": {
            "title": "Max odometer",
            "minimum": 0,
            "type": "integer",
            "description": "Vehicles only."
          },
          "extraSearchParams": {
            "title": "Other craigslist filters",
            "type": "object",
            "description": "Any other craigslist search parameter, as in its URLs, e.g. {\"auto_title_status\": 1, \"laundry\": [1, 4], \"employment_type\": 1, \"is_telecommuting\": 1}.",
            "default": {}
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "date",
              "dateoldest",
              "rel",
              "priceasc",
              "pricedsc",
              "dist"
            ],
            "type": "string",
            "description": "Order craigslist returns results in. Pasted URLs keep their own sort.",
            "default": "date"
          },
          "postedWithinHours": {
            "title": "Posted within (hours)",
            "minimum": 0,
            "maximum": 8760,
            "type": "integer",
            "description": "Keep only postings posted in the last N hours. Pairs well with a schedule. 0 = no limit.",
            "default": 0
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop postings whose title (or body, with details on) contains any of these, e.g. \"wanted\", \"parts only\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeNearby": {
            "title": "Include nearby areas",
            "type": "boolean",
            "description": "craigslist pads small result lists with postings from neighbouring cities (\"more from nearby areas\"). On = keep them (isNearby: true); off = only the city you searched.",
            "default": false
          },
          "withContactOnly": {
            "title": "Only postings with a phone or email",
            "type": "boolean",
            "description": "Keep only postings whose body shows a phone number or email address (turns details on).",
            "default": false
          },
          "includeDetails": {
            "title": "Include posting details",
            "type": "boolean",
            "description": "Open each posting for its full description, attributes (year, odometer, VIN, beds, baths...), all photos, street and postal code, updated time, and phones/emails written in the body. Off = search-card fields only, faster.",
            "default": true
          },
          "imageSize": {
            "title": "Image size",
            "enum": [
              "600x450",
              "1200x900",
              "300x300",
              "50x50c"
            ],
            "type": "string",
            "description": "Size of the photo links in imageUrls.",
            "default": "600x450"
          },
          "monitorMode": {
            "title": "Only new postings (monitor)",
            "type": "boolean",
            "description": "Remember delivered postings per search and return only postings no earlier run delivered. The first run returns everything up to your limits.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor memory name",
            "type": "string",
            "description": "Named key-value store that keeps the memory. Use a different name per independent watch list.",
            "default": "craigslist-monitor"
          },
          "includePriceChanges": {
            "title": "Also return price changes",
            "type": "boolean",
            "description": "With monitoring on, also return a remembered posting again when its price changed (changeType PRICE_CHANGED, previousPrice).",
            "default": false
          },
          "maxResults": {
            "title": "Max postings",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Total postings across all searches. craigslist returns at most 10,000 postings per search; split by sub-area or price to go further. 0 = no limit.",
            "default": 100
          },
          "maxResultsPerSearch": {
            "title": "Max postings per search",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Cap for each city x keyword search (or pasted URL). 0 = only the total limit applies.",
            "default": 0
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (id, link, title, price, place, date, description, contacts, photos) - small rows for AI agents and spreadsheets.",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Cut descriptions to this many characters. 0 = full text.",
            "default": 0
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: craigslist answers direct connections. A proxy you add here is used only for requests craigslist refuses.",
            "default": {
              "useApifyProxy": false
            }
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "Posting pages fetched at the same time.",
            "default": 10
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}