{ "openapi": "3.0.1", "info": { "title": "TractorHouse Scraper", "description": "Scrape TractorHouse.com farm equipment, tractors, construction machinery, trailers, and trucks. Search by keyword, category, manufacturer, price/year/hours range, state, and condition, or fetch full listing detail records by ID/URL.", "version": "1.0", "x-build-id": "QzlrT2BiAbcUc6FnF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~tractorhouse-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-tractorhouse-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/crawlerbros~tractorhouse-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-tractorhouse-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/crawlerbros~tractorhouse-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-tractorhouse-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byListingIds" ], "type": "string", "description": "What to fetch.", "default": "search" }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text search across listing titles/descriptions (mode=search).", "default": "" }, "category": { "title": "Category", "enum": [ "", "all", "attachmentsAll", "tractors", "tractorsLt40hp", "tractors40to99hp", "tractors100to174hp", "tractors175to299hp", "tractors300hpPlus", "harvesters", "harvestEquipment", "plantingEquipment", "tillageEquipment", "hayAndForageEquipment", "chemicalApplicators", "otherEquipment", "manureHandling", "irrigationEquipment", "livestockEquipment", "precisionAg", "precisionAgAttachments", "turfEquipment", "outdoorPower", "lawnMowers", "dozers", "crawlerExcavators", "miniExcavators", "forkliftsLifts", "telehandlersLifts", "loaderBackhoes", "scrapers", "skidSteers", "trenchersCablePlows", "wheelLoaders", "livestockTrailers", "horseTrailers", "flatbedTagTrailers", "cargoEnclosedTrailers", "lowboyTrailers", "openTopTrailers", "hopperGrainTrailers", "beltTrailers", "agTransportTrailers", "gasolineFuelTankTrailers", "pickupTrucks", "farmGrainTrucks", "flatbedTrucks", "serviceUtilityTrucks", "sleeperTrucks", "dayCabTrucks", "cabAndChassisTrucks", "fireTrucks" ], "type": "string", "description": "Restrict to an equipment category (mode=search). Leave unset to search all categories.", "default": "" }, "manufacturer": { "title": "Manufacturer", "enum": [ "", "JOHN DEERE", "CASE IH", "NEW HOLLAND", "KUBOTA", "MASSEY FERGUSON", "CATERPILLAR", "BOBCAT", "CLAAS", "FENDT", "CHALLENGER", "DEUTZ-FAHR", "KRONE", "KUHN", "KINZE", "LANDOLL", "MAHINDRA", "VALTRA", "VERMEER", "SUNFLOWER", "BUSH HOG", "AGCO", "GEHL", "HESSTON", "HORSCH", "JCB", "KOMATSU", "KVERNELAND", "MCCORMICK", "VOLVO", "WOODS", "BRENT", "BRILLION", "DEMCO", "GREAT PLAINS", "UNVERFERTH", "VERSATILE", "ZETOR", "YANMAR", "HITACHI", "KOBELCO" ], "type": "string", "description": "Restrict to a specific manufacturer/brand (mode=search).", "default": "" }, "state": { "title": "State / Province", "enum": [ "", "ALABAMA", "ALASKA", "ARIZONA", "ARKANSAS", "CALIFORNIA", "COLORADO", "CONNECTICUT", "DELAWARE", "FLORIDA", "GEORGIA", "HAWAII", "IDAHO", "ILLINOIS", "INDIANA", "IOWA", "KANSAS", "KENTUCKY", "LOUISIANA", "MAINE", "MARYLAND", "MASSACHUSETTS", "MICHIGAN", "MINNESOTA", "MISSISSIPPI", "MISSOURI", "MONTANA", "NEBRASKA", "NEVADA", "NEW HAMPSHIRE", "NEW JERSEY", "NEW MEXICO", "NEW YORK", "NORTH CAROLINA", "NORTH DAKOTA", "OHIO", "OKLAHOMA", "OREGON", "PENNSYLVANIA", "RHODE ISLAND", "SOUTH CAROLINA", "SOUTH DAKOTA", "TENNESSEE", "TEXAS", "UTAH", "VERMONT", "VIRGINIA", "WASHINGTON", "WEST VIRGINIA", "WISCONSIN", "WYOMING", "ALBERTA", "BRITISH COLUMBIA", "MANITOBA", "NEW BRUNSWICK", "NEWFOUNDLAND", "NOVA SCOTIA", "ONTARIO", "PRINCE EDWARD ISLAND", "QUEBEC", "SASKATCHEWAN" ], "type": "string", "description": "Restrict to listings located in a specific US state or Canadian province (mode=search).", "default": "" }, "condition": { "title": "Condition", "enum": [ "", "Used", "New" ], "type": "string", "description": "Restrict to new or used equipment (mode=search).", "default": "" }, "priceMin": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop listings priced below this amount." }, "priceMax": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop listings priced above this amount." }, "yearMin": { "title": "Min model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Drop listings with a model year below this." }, "yearMax": { "title": "Max model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Drop listings with a model year above this." }, "hoursMin": { "title": "Min hours", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop listings with fewer operating hours than this." }, "hoursMax": { "title": "Max hours", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop listings with more operating hours than this." }, "listingIds": { "title": "Listing IDs or URLs (mode=byListingIds)", "type": "array", "description": "TractorHouse listing IDs (e.g. `257864499`) or full listing URLs to fetch full detail records for.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "TractorHouse's Cloudflare protection blocks direct datacenter requests; this actor uses Apify's free AUTO datacenter proxy group to reach it. No paid/residential proxy is required.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }