{
  "openapi": "3.0.1",
  "info": {
    "title": "🚀 Craigslist Cars Scraper · 5,000 Free Cars/Month",
    "description": "Craigslist Cars Scraper gets you Craigslist cars ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — prices, mileage, photos, VINs, title status and GPS for any make and model. 💰 $1 per 1,000 cars, no start fee. Scrape your first 5,000 cars free every month 🚀",
    "version": "0.0",
    "x-build-id": "qCmWgnibWyiOIiCJY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/omkar-cloud~craigslist-cars-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-omkar-cloud-craigslist-cars-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/omkar-cloud~craigslist-cars-scraper/runs": {
      "post": {
        "operationId": "runs-sync-omkar-cloud-craigslist-cars-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/omkar-cloud~craigslist-cars-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-omkar-cloud-craigslist-cars-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": {
          "makeModels": {
            "title": "Makes & Models",
            "type": "array",
            "description": "Make and model to look for — each is searched separately in every location, e.g. `tesla model 3`, `honda civic`, `ford f-150`. Rows carry a `query` field so you can tell them apart.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Where to search — each is searched separately. A Craigslist site (`newyork`, `sfbay`, `losangeles`, `chicago` — the part before .craigslist.org), a ZIP / postal code (`94103`) or `latitude,longitude` (`40.7128,-74.0060`). ZIP codes and coordinates search a radius.",
            "items": {
              "type": "string"
            }
          },
          "vehicleType": {
            "title": "Vehicle Type",
            "enum": [
              "cars",
              "motorcycles",
              "boats",
              "rvs",
              "trailers",
              "atvs",
              "heavy_equipment",
              "aviation"
            ],
            "type": "string",
            "description": "Kind of vehicle to search.",
            "default": "cars"
          },
          "maxResultsPerSearch": {
            "title": "Max Vehicles per Search",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop each search after this many vehicles (Craigslist serves up to 10,000 per search). Caps your cost: 1,000 vehicles ≈ $1.",
            "default": 120
          },
          "includeDetails": {
            "title": "Scrape Full Vehicle Details",
            "type": "boolean",
            "description": "Opens every listing and adds the full description, VIN when listed, condition, drivetrain, cylinders, paint color, title status, street address and exact coordinates. Detailed rows cost $3 per 1,000 instead of $1.",
            "default": false
          },
          "minPrice": {
            "title": "Min Price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price."
          },
          "maxPrice": {
            "title": "Max Price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price."
          },
          "minYear": {
            "title": "Min Model Year",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Oldest model year, e.g. `2018`."
          },
          "maxYear": {
            "title": "Max Model Year",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Newest model year."
          },
          "minOdometer": {
            "title": "Min Odometer",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest odometer reading."
          },
          "maxOdometer": {
            "title": "Max Odometer",
            "minimum": 0,
            "type": "integer",
            "description": "Highest odometer reading, e.g. `60000`."
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "",
              "owner",
              "dealer"
            ],
            "type": "string",
            "description": "Private owners, dealers or both.",
            "default": ""
          },
          "condition": {
            "title": "Condition",
            "type": "array",
            "description": "Only vehicles in these conditions.",
            "items": {
              "type": "string",
              "enum": [
                "new",
                "like_new",
                "excellent",
                "good",
                "fair",
                "salvage"
              ],
              "enumTitles": [
                "New",
                "Like New",
                "Excellent",
                "Good",
                "Fair",
                "Salvage"
              ]
            }
          },
          "transmission": {
            "title": "Transmission",
            "type": "array",
            "description": "Only these transmissions.",
            "items": {
              "type": "string",
              "enum": [
                "manual",
                "automatic",
                "other"
              ],
              "enumTitles": [
                "Manual",
                "Automatic",
                "Other"
              ]
            }
          },
          "fuelType": {
            "title": "Fuel",
            "type": "array",
            "description": "Only these fuel types.",
            "items": {
              "type": "string",
              "enum": [
                "gas",
                "diesel",
                "hybrid",
                "electric",
                "other"
              ],
              "enumTitles": [
                "Gas",
                "Diesel",
                "Hybrid",
                "Electric",
                "Other"
              ]
            }
          },
          "bodyType": {
            "title": "Body Type",
            "type": "array",
            "description": "Only these body styles.",
            "items": {
              "type": "string",
              "enum": [
                "bus",
                "convertible",
                "coupe",
                "hatchback",
                "minivan",
                "offroad",
                "pickup",
                "sedan",
                "truck",
                "suv",
                "wagon",
                "van",
                "other"
              ],
              "enumTitles": [
                "Bus",
                "Convertible",
                "Coupe",
                "Hatchback",
                "Minivan",
                "Offroad",
                "Pickup",
                "Sedan",
                "Truck",
                "SUV",
                "Wagon",
                "Van",
                "Other"
              ]
            }
          },
          "drivetrain": {
            "title": "Drivetrain",
            "type": "array",
            "description": "Only these drivetrains.",
            "items": {
              "type": "string",
              "enum": [
                "fwd",
                "rwd",
                "4wd"
              ],
              "enumTitles": [
                "FWD",
                "RWD",
                "4WD"
              ]
            }
          },
          "titleStatus": {
            "title": "Title Status",
            "type": "array",
            "description": "Only these title statuses.",
            "items": {
              "type": "string",
              "enum": [
                "clean",
                "salvage",
                "rebuilt",
                "parts_only",
                "lien",
                "missing"
              ],
              "enumTitles": [
                "Clean",
                "Salvage",
                "Rebuilt",
                "Parts Only",
                "Lien",
                "Missing"
              ]
            }
          },
          "paintColor": {
            "title": "Paint Color",
            "type": "array",
            "description": "Only these colors.",
            "items": {
              "type": "string",
              "enum": [
                "black",
                "blue",
                "brown",
                "green",
                "grey",
                "orange",
                "purple",
                "red",
                "silver",
                "white",
                "yellow",
                "custom"
              ],
              "enumTitles": [
                "Black",
                "Blue",
                "Brown",
                "Green",
                "Grey",
                "Orange",
                "Purple",
                "Red",
                "Silver",
                "White",
                "Yellow",
                "Custom"
              ]
            }
          },
          "radius": {
            "title": "Radius",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Search radius around a ZIP code or coordinates, in miles (km on Canadian sites). Ignored for site names. Craigslist's default is 30."
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "",
              "newest",
              "oldest",
              "price_low",
              "price_high",
              "distance"
            ],
            "type": "string",
            "description": "Order of the results. `distance` needs a ZIP code or coordinates as the location.",
            "default": ""
          },
          "hasImage": {
            "title": "Only With Photos",
            "type": "boolean",
            "description": "Only vehicles that have photos.",
            "default": false
          },
          "postedToday": {
            "title": "Posted Today",
            "type": "boolean",
            "description": "Only vehicles posted today.",
            "default": false
          },
          "hideDuplicates": {
            "title": "Hide Duplicates",
            "type": "boolean",
            "description": "Collapse near-identical listings into one.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}