{
  "openapi": "3.0.1",
  "info": {
    "title": "CarGurus Deal Rating & Dealer Inventory Scraper",
    "description": "Search CarGurus by make, model, ZIP code and price range, fetch one listing by ID, or scrape a pasted search URL, with deal rating, mileage and dealer details for every listing.",
    "version": "1.0",
    "x-build-id": "qABQVwWb0mhDOag9w"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/vexaloom-labs~cargurus-deal-rating-and-dealer-inventory-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-vexaloom-labs-cargurus-deal-rating-and-dealer-inventory-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/vexaloom-labs~cargurus-deal-rating-and-dealer-inventory-scraper/runs": {
      "post": {
        "operationId": "runs-sync-vexaloom-labs-cargurus-deal-rating-and-dealer-inventory-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/vexaloom-labs~cargurus-deal-rating-and-dealer-inventory-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-vexaloom-labs-cargurus-deal-rating-and-dealer-inventory-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "byListingId",
              "byUrl"
            ],
            "type": "string",
            "description": "How to find listings.",
            "default": "search"
          },
          "make": {
            "title": "Make (search mode)",
            "enum": [
              "Acura",
              "Alfa Romeo",
              "Audi",
              "Bentley",
              "BMW",
              "Buick",
              "Cadillac",
              "Chevrolet",
              "Chrysler",
              "Dodge",
              "Ferrari",
              "Ford",
              "Genesis",
              "GMC",
              "Honda",
              "Hyundai",
              "INFINITI",
              "Jaguar",
              "Jeep",
              "Kia",
              "Land Rover",
              "Lexus",
              "Lincoln",
              "Maserati",
              "Mazda",
              "Mercedes-Benz",
              "MINI",
              "Mitsubishi",
              "Nissan",
              "Porsche",
              "RAM",
              "Subaru",
              "Tesla",
              "Toyota",
              "Volkswagen",
              "Volvo",
              "AM General",
              "AMC",
              "Armstrong-Siddeley",
              "Aston Martin",
              "Auburn",
              "Austin",
              "Austin-Healey",
              "Bertone",
              "Bricklin",
              "Bugatti",
              "Citroen",
              "Continental",
              "Cord",
              "Daewoo",
              "Daihatsu",
              "Datsun",
              "De Tomaso",
              "DeLorean",
              "DeSoto",
              "Durant",
              "Eagle",
              "Edsel",
              "Excalibur",
              "FIAT",
              "Fisker",
              "Freightliner",
              "Geo",
              "Graham",
              "Hudson",
              "Hummer",
              "Ineos",
              "Intermeccanica",
              "International Harvester",
              "Isuzu",
              "Jensen",
              "Kaiser",
              "Karma",
              "Lada",
              "Lamborghini",
              "Lancia",
              "LaSalle",
              "Lotus",
              "Lucid",
              "Maybach",
              "McLaren",
              "Mercury",
              "MG",
              "Mobility Ventures",
              "Morgan",
              "Morris",
              "Nash",
              "Oldsmobile",
              "Opel",
              "Overland",
              "Packard",
              "Paige",
              "Panoz",
              "Peerless",
              "Peugeot",
              "Pininfarina",
              "Plymouth",
              "Polestar",
              "Pontiac",
              "Renault",
              "REO",
              "Rivian",
              "Rolls-Royce",
              "Rover",
              "Saab",
              "Saturn",
              "Scion",
              "Shelby",
              "smart",
              "SSC",
              "Studebaker",
              "Sunbeam",
              "Suzuki",
              "Triumph",
              "VinFast",
              "VPG",
              "Willys"
            ],
            "type": "string",
            "description": "Vehicle manufacturer to search. Leave empty to search every make near the ZIP code."
          },
          "model": {
            "title": "Model (search mode)",
            "type": "string",
            "description": "Model name, e.g. Camry or F-150. Leave empty for every model of the chosen make."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "",
              "New",
              "Used",
              "Certified Pre-Owned"
            ],
            "type": "string",
            "description": "New, used or certified pre-owned inventory. Certified searches require a make.",
            "default": ""
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "best_deal",
              "best_match",
              "lowest_price",
              "highest_price",
              "lowest_mileage",
              "highest_mileage",
              "newest_year",
              "oldest_year",
              "closest"
            ],
            "type": "string",
            "description": "Result ordering.",
            "default": "best_deal"
          },
          "zipCode": {
            "title": "ZIP code (search mode)",
            "type": "string",
            "description": "5-digit US ZIP code used to center the search, e.g. 10001."
          },
          "distanceMiles": {
            "title": "Search radius (miles)",
            "enum": [
              "10",
              "25",
              "50",
              "75",
              "100",
              "150",
              "200",
              "500"
            ],
            "type": "string",
            "description": "How far from the ZIP code to search.",
            "default": "50"
          },
          "minPrice": {
            "title": "Min price (USD)",
            "minimum": 0,
            "maximum": 9999999,
            "type": "integer",
            "description": "Minimum listing price in US dollars."
          },
          "maxPrice": {
            "title": "Max price (USD)",
            "minimum": 0,
            "maximum": 9999999,
            "type": "integer",
            "description": "Maximum listing price in US dollars."
          },
          "maxMileage": {
            "title": "Max mileage",
            "minimum": 0,
            "maximum": 999999,
            "type": "integer",
            "description": "Maximum odometer reading in miles."
          },
          "dealRating": {
            "title": "Deal rating filter",
            "enum": [
              "",
              "GREAT_PRICE",
              "GOOD_PRICE",
              "FAIR_PRICE",
              "POOR_PRICE",
              "OVERPRICED",
              "NA",
              "OUTLIER"
            ],
            "type": "string",
            "description": "Only return listings CarGurus rates at this level. Leave empty for every rating.",
            "default": ""
          },
          "bodyType": {
            "title": "Body style",
            "enum": [
              "",
              "Coupe",
              "Convertible",
              "Hatchback",
              "Minivan",
              "Pickup Truck",
              "Sedan",
              "SUV / Crossover",
              "Van",
              "Wagon"
            ],
            "type": "string",
            "description": "Limit results to one body style.",
            "default": ""
          },
          "fuelType": {
            "title": "Fuel type",
            "enum": [
              "",
              "Gasoline",
              "Hybrid",
              "Electric",
              "Diesel",
              "Biodiesel",
              "Flex Fuel Vehicle"
            ],
            "type": "string",
            "description": "Limit results to one fuel type.",
            "default": ""
          },
          "transmission": {
            "title": "Transmission",
            "enum": [
              "",
              "Automatic",
              "Manual"
            ],
            "type": "string",
            "description": "Limit results by transmission.",
            "default": ""
          },
          "drivetrain": {
            "title": "Drivetrain",
            "enum": [
              "",
              "All-Wheel Drive",
              "Front-Wheel Drive",
              "Rear-Wheel Drive",
              "Four-Wheel Drive",
              "4X2"
            ],
            "type": "string",
            "description": "Limit results by driven wheels.",
            "default": ""
          },
          "onlyWithPhotos": {
            "title": "Only listings with photos",
            "type": "boolean",
            "description": "Skip listings that have no photos.",
            "default": false
          },
          "onlyPriceDrops": {
            "title": "Only recent price drops",
            "type": "boolean",
            "description": "Only return listings whose price dropped recently.",
            "default": false
          },
          "listingId": {
            "title": "Listing ID (byListingId mode)",
            "type": "string",
            "description": "CarGurus listing ID from a listing URL or the /details/<id> page."
          },
          "url": {
            "title": "CarGurus URL (byUrl mode)",
            "type": "string",
            "description": "A CarGurus search results URL or listing URL. Old action-style search URLs are accepted too."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of listings to emit.",
            "default": 5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}