{ "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": "p7JDadcZiF4skqSud" }, "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 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": "Maximum items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stops after this many rows (all record types together; with condition reports on, each lot gives two rows). Free plans are limited to 10 items per run.", "default": 50 }, "locations": { "title": "Public 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": [] }, "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": "" }, "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": "Minimum mileage", "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": "Maximum mileage", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Odometer reading up to this value, for example 60000. Empty means no limit." }, "minCondition": { "title": "Minimum condition grade", "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" } }, "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": "" }, "saleDate": { "title": "Sale date", "type": "string", "description": "Only lots that run on this day, written YYYY-MM-DD, for example 2026-10-27. Empty means every scheduled sale day.", "default": "" }, "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" }, "includeConditionReport": { "title": "Add condition report and build details", "type": "boolean", "description": "On: every lot also gives an auction-lot-detail-record with the damage list, tires, keys, the decoded build (engine, transmission, equipment, MSRP, warranty) and the grade text. Slower runs and one extra row per lot. Off: lot rows only.", "default": false }, "includeContactDetails": { "title": "Include 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 }, "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 }, "states": { "title": "States (locations mode)", "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" } }, "startUrls": { "title": "Addresses", "type": "array", "description": "urls mode. A public auction (https://publicauction.manheim.com/locations/BWAE), a lot (https://publicauction.manheim.com/listings/id/Simulcast.BWAE.14084279), a lot by VIN or a location page of site.manheim.com (https://site.manheim.com/locations/manheim-baltimore-washington/).", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "vins": { "title": "VINs", "type": "array", "description": "urls mode. 17-character VINs. Each one is looked up in the public auction listings. A VIN that is not listed returns one note.", "default": [], "items": { "type": "string" } }, "onlyNew": { "title": "Only new rows (monitor)", "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": "Report lot changes", "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", "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 rows", "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 } } } } } } } } } }