{
  "openapi": "3.0.1",
  "info": {
    "title": "Manheim Scraper - Public Auction Cars, VINs and Photos",
    "description": "Scrape the Manheim public auction: live vehicle lots with VIN, make, model, year, mileage, condition grade, title status, photos, lane and run number, plus sale schedules and Manheim locations. Filter by make, year, mileage, grade, body type and sale day. Export JSON, CSV or Excel.",
    "version": "0.1",
    "x-build-id": "KFqDeJJF8kokxbWH0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/recordsdata~manheim-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-recordsdata-manheim-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/recordsdata~manheim-scraper/runs": {
      "post": {
        "operationId": "runs-sync-recordsdata-manheim-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/recordsdata~manheim-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-recordsdata-manheim-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": {
          "mode": {
            "title": "What do you want to collect?",
            "enum": [
              "lots",
              "sales",
              "locations",
              "urls"
            ],
            "type": "string",
            "description": "lots = the vehicles listed for the public auction of each location, found by the filters below. sales = one row per location and sale day (lanes, lot count, makes, body types). locations = the Manheim auction sites (address, hours, sale days). urls = lot, VIN, location or public auction addresses that you list.",
            "default": "lots"
          },
          "maxItems": {
            "title": "Max rows to return",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "How many rows to return, for example 100. Free plan: capped at 10 per run. With condition reports on, each lot gives two rows.",
            "default": 50
          },
          "locations": {
            "title": "Auction locations",
            "type": "array",
            "description": "Manheim locations whose lanes are open to the public (lots and sales modes). Empty means all of them. A location with no sale scheduled returns no lots.",
            "items": {
              "type": "string",
              "enum": [
                "AAA",
                "BWAE",
                "CINA",
                "CLEV",
                "DADE",
                "LMAA",
                "PATF",
                "FAA",
                "AAAW",
                "HAA",
                "INDY",
                "KEYA",
                "SAPL",
                "BCMP",
                "MISS",
                "NASH",
                "NVAA",
                "OAA",
                "PXAA",
                "PAA",
                "SAAA",
                "SVAA",
                "TBAA"
              ],
              "enumTitles": [
                "Manheim Atlanta (GA, AAA)",
                "Manheim Baltimore-Washington (MD, BWAE)",
                "Manheim Cincinnati (OH, CINA)",
                "Manheim Cleveland (OH, CLEV)",
                "Manheim Daytona Beach (FL, DADE)",
                "Manheim Fort Lauderdale (FL, LMAA)",
                "Manheim Flint (MI, PATF)",
                "Manheim Fredericksburg (VA, FAA)",
                "Manheim Georgia (GA, AAAW)",
                "Manheim Harrisonburg (VA, HAA)",
                "Manheim Indianapolis (IN, INDY)",
                "Manheim Keystone Pennsylvania (PA, KEYA)",
                "Manheim Lafayette (LA, SAPL)",
                "Manheim Maryland (MD, BCMP)",
                "Manheim Mississippi (MS, MISS)",
                "Manheim Nashville (TN, NASH)",
                "Manheim Nevada (NV, NVAA)",
                "Manheim Ohio (OH, OAA)",
                "Manheim Phoenix (AZ, PXAA)",
                "Manheim Portland (OR, PAA)",
                "Manheim San Antonio (TX, SAAA)",
                "Manheim Statesville (NC, SVAA)",
                "Manheim Tampa (FL, TBAA)"
              ]
            },
            "default": []
          },
          "saleDate": {
            "title": "Sale date (YYYY-MM-DD)",
            "type": "string",
            "description": "Only lots selling that day. Example: 2026-10-27. Empty means every scheduled day.",
            "default": ""
          },
          "makes": {
            "title": "Makes",
            "type": "array",
            "description": "Keeps only lots of these makes, for example Toyota, Ford, BMW. Case and accents do not matter. Empty means every make. If none of the locations lists a make you typed, the run returns one note with the makes available now.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Keeps only lots whose model, trim or title contains this text, for example Camry, F-150 or Model 3. Works best together with a make. Empty means every model.",
            "default": ""
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Free text searched in the lot data (make, model, trim, options, announcements), for example hybrid or leather. Empty means no text filter.",
            "default": ""
          },
          "yearFrom": {
            "title": "Model year from",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Only vehicles of this model year or newer, for example 2020. Empty means no limit."
          },
          "yearTo": {
            "title": "Model year to",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Only vehicles of this model year or older, for example 2024. Empty means no limit."
          },
          "minMileage": {
            "title": "Min mileage (miles)",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Odometer reading from this value up, in the unit the lot uses (miles for nearly all lots). Empty means no limit."
          },
          "maxMileage": {
            "title": "Max mileage (miles)",
            "minimum": 0,
            "maximum": 5000000,
            "type": "integer",
            "description": "Odometer reading up to this value, for example 60000. Empty means no limit."
          },
          "minCondition": {
            "title": "Min condition grade (0-5)",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Manheim condition grade from 0 to 5, for example 3.5. Lots without a grade are left out when this is set. Empty means no limit."
          },
          "bodyTypes": {
            "title": "Body types",
            "type": "array",
            "description": "Body styles as Manheim writes them, for example SUV, Sedan, Pickup, Coupe, Van or Hatchback. Empty means every body type.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sellerTypes": {
            "title": "Seller types",
            "type": "array",
            "description": "Type of consignor, for example Fleet/Lease, Finance, Credit Union, Bank, Government Agency, Captive Finance, Independent. Empty means every type.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "asIsOnly": {
            "title": "As-is lots only",
            "type": "boolean",
            "description": "Only lots sold as is (no arbitration).",
            "default": false
          },
          "sortBy": {
            "title": "Sort lots by",
            "enum": [
              "lane-run",
              "year-newest",
              "year-oldest",
              "mileage-lowest",
              "mileage-highest",
              "condition-best",
              "make"
            ],
            "type": "string",
            "description": "Order of the lots inside each location. Sale order follows the lanes and run numbers of the auction.",
            "default": "lane-run"
          },
          "states": {
            "title": "States",
            "type": "array",
            "description": "Locations mode: keeps only locations in these states, written as the two-letter code or the full name, for example MD or Maryland. Empty means every state.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "publicAuctionOnly": {
            "title": "Only locations with a public auction",
            "type": "boolean",
            "description": "Locations mode: keeps only the sites that sell to the public through publicauction.manheim.com.",
            "default": false
          },
          "includeContactDetails": {
            "title": "Include staff contact details",
            "type": "boolean",
            "description": "Locations mode: adds the staff names, titles, phone numbers and the email addresses printed on the location pages. Off keeps them out. Main line and fax numbers of a location are always included. Names of individual sellers are never output.",
            "default": false
          },
          "startUrls": {
            "title": "Links (auction, lot or location pages)",
            "type": "array",
            "description": "Example: https://publicauction.manheim.com/locations/BWAE. Used only in the addresses mode.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "vins": {
            "title": "VINs (17 characters)",
            "type": "array",
            "description": "Example: 1HGCM82633A004352. Used only in the addresses mode.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeConditionReport": {
            "title": "Add condition report and build details",
            "type": "boolean",
            "description": "On: each lot also returns a detail row with damage list, tires, keys and decoded build. Doubles the rows (and billed events) per lot.",
            "default": false
          },
          "onlyNew": {
            "title": "Only new lots since the last run",
            "type": "boolean",
            "description": "Skips every lot seen in an earlier run with the same monitor name, so scheduled runs return only the lots that are new.",
            "default": false
          },
          "trackChanges": {
            "title": "Also report changed lots",
            "type": "boolean",
            "description": "Needs Only new rows. A lot seen before whose status, sale day, lane, run number, grade or bid changed comes back as a lot-change-record with the previous values.",
            "default": false
          },
          "stateKey": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Name of the memory used by Only new rows. Use one name per saved search. Empty derives a name from your filters.",
            "default": ""
          },
          "resetSeen": {
            "title": "Forget seen lots",
            "type": "boolean",
            "description": "Clears the memory of the monitor name before this run.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Off by default: Manheim answers requests from Apify servers directly. Turn it on only if you see blocked requests in the log.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}