{ "openapi": "3.0.1", "info": { "title": "BigIron Auction Scraper - Farm Equipment & Sullivan Lots", "description": "Reads every open lot on BigIron.com and Sullivan Auctioneers: 6,500+ live farm, construction, transportation and livestock lots with make, model, year, current bid, closing time and location.", "version": "0.1", "x-build-id": "5yY6eORR1NO5jRzEF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~bigiron-auctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-bigiron-auctions-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~bigiron-auctions-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-bigiron-auctions-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~bigiron-auctions-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-bigiron-auctions-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": { "searchTerm": { "title": "Search term", "type": "string", "description": "Free text searched across lot titles and descriptions, for example 'grain cart' or 'John Deere combine'. Leave empty to take every open lot that matches the filters below." }, "searchMode": { "title": "Search mode", "enum": [ "All", "Phrase", "Any" ], "type": "string", "description": "How the search term is matched. All: the lot must contain every word. Phrase: the lot must contain the exact phrase. Any: the lot may contain any of the words.", "default": "All" }, "industries": { "title": "Industries", "uniqueItems": true, "type": "array", "description": "BigIron's top level industry buckets. Leave empty for every industry. Verified open lot counts on 2026-08-31: Agriculture 4,361, Construction 1,347, Transportation 887, Other 647, Livestock 406, Collector Cars 15.", "items": { "type": "string", "enum": [ "Agriculture", "Construction", "Transportation", "Livestock", "Other", "CollectorCars" ], "enumTitles": [ "Agriculture", "Construction", "Transportation", "Livestock", "Other", "Collector Cars" ] } }, "states": { "title": "States", "uniqueItems": true, "type": "array", "description": "Two letter state codes, taken from BigIron's own state picker. Leave empty for the whole country.", "items": { "type": "string", "enum": [ "AK", "AL", "AR", "AZ", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "ND", "NE", "NH", "NJ", "NM", "NV", "NY", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY" ] } }, "providers": { "title": "Listing providers", "uniqueItems": true, "type": "array", "description": "BigIron runs its own sales and Sullivan Auctioneers sales on the same platform. Leave empty for both.", "items": { "type": "string", "enum": [ "BigIron", "Sullivan" ], "enumTitles": [ "BigIron", "Sullivan Auctioneers" ] } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: limited to 10 items (preview). Paid users: up to 1,000,000." }, "outputs": { "title": "Outputs", "uniqueItems": true, "type": "array", "description": "What the run collects. Lots is the auction inventory. Auctions is the upcoming sale calendar, about 131 rows. Filter values is a directory of every valid value for the filters above with its live lot count, about 900 rows, which is how you learn the exact strings the filters expect. Pick more than one and maxItems is split evenly between them, with whatever one does not use rolling into the next.", "items": { "type": "string", "enum": [ "lots", "auctions", "facets" ], "enumTitles": [ "Auction lots", "Upcoming auction calendar", "Filter value directory" ] }, "default": [ "lots" ] }, "makes": { "title": "Makes", "uniqueItems": true, "type": "array", "description": "Exact manufacturer names as BigIron spells them, for example 'John Deere', 'Case IH', 'Allis-Chalmers'. Turn on the facet directory below to pull the live list with counts.", "items": { "type": "string" } }, "models": { "title": "Models", "uniqueItems": true, "type": "array", "description": "Exact model designations, for example '4020' or '8R 410'. Most useful combined with a make.", "items": { "type": "string" } }, "categories": { "title": "Categories", "uniqueItems": true, "type": "array", "description": "BigIron category paths in the form 'Parent : Child', for example 'Tractors : Tractors 2WD' or 'Miscellaneous : Tires/Rims'.", "items": { "type": "string" } }, "years": { "title": "Model years", "uniqueItems": true, "type": "array", "description": "A single year such as '2015', or one of BigIron's decade buckets such as '1970 - 1979'. Arbitrary ranges are not supported by the site and return nothing.", "items": { "type": "string" } }, "engineHours": { "title": "Engine hour buckets", "uniqueItems": true, "type": "array", "description": "BigIron's own hour buckets, spelled exactly: '< 100', '100 - 499', '500 - 999', '5,000 - 5,999'.", "items": { "type": "string" } }, "horsepowers": { "title": "Horsepower buckets", "uniqueItems": true, "type": "array", "description": "BigIron's own horsepower buckets, spelled exactly: '10 - 29', '30 - 49', '50 - 99', '100 - 149', '150 - 199', '200 - 249'.", "items": { "type": "string" } }, "sizes": { "title": "Size buckets", "uniqueItems": true, "type": "array", "description": "Tyre and dimension buckets as the site spells them, for example '6.00-16 Front Tires'.", "items": { "type": "string" } }, "currentBidBuckets": { "title": "Current bid buckets", "uniqueItems": true, "type": "array", "description": "Current bid ranges as the site spells them: '< $100', '$100 - $499', '$500 - $999', '$1,000 - $1,999', '$10,000 - $19,999' and so on.", "items": { "type": "string" } }, "auctions": { "title": "Auction events", "uniqueItems": true, "type": "array", "description": "Full auction event names as BigIron writes them, for example 'Sep 16, 2026 - Equipment Auction'.", "items": { "type": "string" } }, "sellers": { "title": "Sellers (consignments)", "uniqueItems": true, "type": "array", "description": "Consignment names, for example 'Mark Kepler Retirement' or 'Larson Family Farms Retirement'.", "items": { "type": "string" } }, "counties": { "title": "Counties", "uniqueItems": true, "type": "array", "description": "County names without the word County, for example 'Platte' or 'Buffalo'.", "items": { "type": "string" } }, "zipCode": { "title": "ZIP code", "type": "string", "description": "Anchor ZIP for a radius search. Needs the radius below to do anything." }, "distanceMiles": { "title": "Radius in miles", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Miles around the ZIP code above. BigIron's own picker defaults to 500." }, "sortBy": { "title": "Sort order", "enum": [ "Start-Ascending", "Start-Descending", "State-Ascending", "State-Descending" ], "type": "string", "description": "The site's own sort options. Sale time earliest first is what the site itself shows.", "default": "Start-Ascending" }, "skipClosedLots": { "title": "Skip lots whose sale already ended", "type": "boolean", "description": "BigIron's open list carries a small number of lots whose closing time has already passed and that read as Sold. Leave this on to drop them. Measured on 2026-08-31: 1 stale lot in the first 50 of 6,486.", "default": true }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Paste BigIron lot URLs (https://www.bigiron.com/Lots/...) to scrape those exact lots instead of running a search. Ignored when empty.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeDescription": { "title": "Include the seller's description", "type": "boolean", "description": "Opens each lot page and adds the full seller description plus the date the listing was last updated. One extra request per lot.", "default": false }, "includeSpecifications": { "title": "Include the specification table", "type": "boolean", "description": "Adds the lot's specification rows: serial number, engine hours, horsepower, tyre sizes and every other attribute the seller filled in.", "default": false }, "includePhotos": { "title": "Include full size photos", "type": "boolean", "description": "Adds every full resolution photo URL from the lot gallery, plus the photo count.", "default": false }, "includeContacts": { "title": "Include the equipment contact", "type": "boolean", "description": "Adds the BigIron representative named on the lot: name, territory, phone and email. Email is decoded from the page's obfuscation.", "default": false }, "includeAttachments": { "title": "Include attachments", "type": "boolean", "description": "Adds the additional resources on the lot page: spec sheets, manuals, title documents and other PDFs.", "default": false }, "includeTerms": { "title": "Include terms, loading and premium", "type": "boolean", "description": "Adds the buyer's premium, loading dock availability, loading assistance notes and the lot's disclaimer text.", "default": false }, "includeCategoryPath": { "title": "Include the full category path", "type": "boolean", "description": "Adds the breadcrumb category hierarchy from the lot page, which is deeper than the single category on the listing row.", "default": false }, "includeRawLot": { "title": "Include the raw lot JSON", "type": "boolean", "description": "Adds BigIron's own untouched lot object exactly as the page embeds it. Costs nothing extra to fetch; useful when you want a field we did not map.", "default": 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 } } }, "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 } } } } } } } } } }