{
  "openapi": "3.0.1",
  "info": {
    "title": "Edmunds Scraper | Car Listings, Prices and Deal Ratings",
    "description": "Edmunds scraper for US car listings: asking price, MSRP, Edmunds market value, deal rating, price history, days on Edmunds, owners, accidents, equipment and dealer contact. Search by make and model, ZIP code, Edmunds link or VIN list. 100 listings in 11 seconds, 81 fields each, no account needed.",
    "version": "1.0",
    "x-build-id": "u54rtJXCJtHaqfFSi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~edmunds-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-edmunds-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/silentflow~edmunds-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-edmunds-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/silentflow~edmunds-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-edmunds-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": {
          "searchQueries": {
            "title": "🔎 Make and model",
            "type": "array",
            "description": "One search per line: a make and model (<code>Toyota Camry</code>, <code>Honda CR-V</code>), a make alone (<code>Ford</code>), or with model years (<code>2020-2023 Tesla Model 3</code>, <code>2021 Ford F-150</code>). Each search returns up to the cap below, near the ZIP code you set.",
            "items": {
              "type": "string"
            }
          },
          "vehicleIds": {
            "title": "🔑 VINs",
            "type": "array",
            "description": "Vehicle identification numbers to look up (<code>1HGCV1F14MA114136</code>), or the Edmunds page of a car. Each VIN for sale gives one row, whatever the cap below; a sold car is reported in the log and gives no row. Paste hundreds at once to revalue a whole stock or a loan book.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Edmunds links",
            "type": "array",
            "description": "Paste a search from edmunds.com with its filters already set (<code>edmunds.com/inventory/srp.html?make=honda&model=cr-v&dealtype=Great</code>), a page such as <code>edmunds.com/used-toyota-camry/</code>, or the page of one car. The link's own location and filters win over the ones below.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "zipCode": {
            "title": "📍 ZIP code",
            "type": "string",
            "description": "A US ZIP code (<code>90210</code>). Distances to each dealer are measured from it. Empty searches nationwide."
          },
          "radius": {
            "title": "📏 Radius (miles)",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How far from the ZIP code to look, from 1 to 500 miles. A wider radius finds more cars.",
            "default": 50
          },
          "maxItems": {
            "title": "🔢 Max listings per search",
            "minimum": 1,
            "type": "integer",
            "description": "The most cars each search or link returns. 100 cars take about 20 seconds. Edmunds shows up to 10,000 cars per search: split a larger market by model year, price or ZIP code.",
            "default": 100
          },
          "inventoryType": {
            "title": "🚗 Condition",
            "type": "array",
            "description": "Used, certified pre-owned, new, or any mix. Used and certified cars carry their history (owners, accidents, title); new cars carry the manufacturer's offers.",
            "items": {
              "type": "string",
              "enum": [
                "used",
                "cpo",
                "new"
              ],
              "enumTitles": [
                "Used",
                "Certified pre-owned",
                "New"
              ]
            },
            "default": [
              "used",
              "cpo"
            ]
          },
          "maxPrice": {
            "title": "💵 Max price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only cars listed at this price or less (<code>25000</code>). Empty keeps every price."
          },
          "maxMileage": {
            "title": "🛣️ Max mileage",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only cars with this many miles or fewer (<code>60000</code>). Empty keeps every mileage."
          },
          "sortBy": {
            "title": "↕️ Sort by",
            "enum": [
              "relevance",
              "newest",
              "price_low",
              "price_high",
              "mileage_low",
              "best_deal",
              "distance"
            ],
            "type": "string",
            "description": "Order of the cars, which decides which ones fit under the cap. Best deals first puts the cars furthest below their Edmunds market value on top.",
            "default": "relevance"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}