{ "openapi": "3.0.1", "info": { "title": "AuctionTime Equipment Scraper", "description": "Scrapes heavy equipment auction listings from AuctionTime.com by keyword, category, manufacturer, year, price, and state. Returns each listing as a flat row with specs, current bid, and auction details.", "version": "1.0", "x-build-id": "7f4eJsTMeFStUhzGp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~auctiontime-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-auctiontime-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/parseforge~auctiontime-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-auctiontime-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/parseforge~auctiontime-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-auctiontime-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": { "searchQuery": { "title": "Equipment make, model, or keyword", "type": "string", "description": "Keyword to search for, exactly as you would type it into the search box on AuctionTime.com (e.g. 'excavator', 'john deere 4440', 'dump truck'). Leave empty to collect every listing that matches the other filters." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many listings to collect per run. Results arrive in pages of 28, so the run stops as soon as this number is reached." }, "auctionStatus": { "title": "Which auctions", "enum": [ "upcoming", "ended", "all" ], "type": "string", "description": "Which auctions to search. Current and upcoming auctions (about 42,000 lots) carry live bid amounts, bid counts and the auction clock. Completed auctions (about 2.3 million records) carry the equipment, location and sale date, but not the winning amount: AuctionTime only shows final bids to logged-in users.", "default": "upcoming" }, "category": { "title": "Category ID", "type": "string", "description": "Numeric category ID. Pick a category on AuctionTime.com and copy the `category=` value out of the address bar: the same field accepts both a whole group (e.g. 464 covers farm attachments, 173000 covers boats) and a single sub-category. Verified examples: 464 returns roughly 7,400 lots, 4 returns roughly 5,000 towable and light equipment lots." }, "manufacturer": { "title": "Manufacturer", "type": "string", "description": "Manufacturer name as AuctionTime spells it, e.g. 'JOHN DEERE', 'CATERPILLAR', 'KOMATSU'." }, "yearMin": { "title": "Year Min", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Earliest year of manufacture to include." }, "yearMax": { "title": "Year Max", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Latest year of manufacture to include." }, "state": { "title": "State or province", "type": "string", "description": "Where the equipment is located. Accepts either the full name ('Texas') or the two-letter code ('TX'); US states and Canadian provinces both work." }, "startUrl": { "title": "AuctionTime search URL", "type": "string", "description": "Advanced: paste a ready-made AuctionTime.com search URL and it is used exactly as-is, ignoring every filter above. Must start with https://www.auctiontime.com/listings/search. Search pages only, not individual listing pages." } } }, "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 } } } } } } } } } }