{ "openapi": "3.0.1", "info": { "title": "MachineryTrader Discovery — US Heavy Equipment", "description": "Generate fresh commercial leads from MachineryTrader.com, the #1 US heavy-equipment marketplace. Detects new, active and disappeared listings in real time so you can identify dealers loading inventory, measure model sell-through, and feed your sales pipeline with high-intent signals.", "version": "1.1", "x-build-id": "GO87EpcHXR6CLbWYt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~machinerytrader-discovery/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-machinerytrader-discovery", "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/rastriq~machinerytrader-discovery/runs": { "post": { "operationId": "runs-sync-rastriq-machinerytrader-discovery", "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/rastriq~machinerytrader-discovery/run-sync": { "post": { "operationId": "run-sync-rastriq-machinerytrader-discovery", "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": { "cat__excavators": { "title": "Excavators", "type": "boolean", "description": "Scrape Excavators listings (all types).", "default": true }, "cat__mini_excavators": { "title": "Mini Excavators", "type": "boolean", "description": "Scrape Mini Excavators listings.", "default": false }, "cat__crawler_excavators": { "title": "Crawler Excavators", "type": "boolean", "description": "Scrape Crawler Excavators listings.", "default": false }, "cat__wheel_loaders": { "title": "Wheel Loaders", "type": "boolean", "description": "Scrape Wheel Loaders listings.", "default": false }, "cat__skid_steers": { "title": "Skid Steers", "type": "boolean", "description": "Scrape Skid Steers listings.", "default": false }, "cat__track_skid_steers": { "title": "Track Skid Steers", "type": "boolean", "description": "Scrape Track Skid Steers listings.", "default": false }, "cat__dozers": { "title": "Dozers", "type": "boolean", "description": "Scrape Dozers listings.", "default": false }, "cat__cranes": { "title": "Cranes", "type": "boolean", "description": "Scrape Cranes listings.", "default": false }, "cat__loader_backhoes": { "title": "Loader Backhoes", "type": "boolean", "description": "Scrape Loader Backhoes listings.", "default": false }, "cat__telehandlers_lifts": { "title": "Telehandlers", "type": "boolean", "description": "Scrape Telehandlers listings.", "default": false }, "cat__forklifts_lifts": { "title": "Forklifts", "type": "boolean", "description": "Scrape Forklifts listings.", "default": false }, "cat__lifts": { "title": "Lifts", "type": "boolean", "description": "Scrape Lifts (boom/scissor) listings.", "default": false }, "cat__off_highway_trucks": { "title": "Off-Highway Trucks", "type": "boolean", "description": "Scrape Off-Highway Trucks listings.", "default": false }, "cat__dump_trucks": { "title": "Dump Trucks", "type": "boolean", "description": "Scrape Dump Trucks listings (id 16014). Note: overlaps with Trucks (16000) and Off-Highway Trucks (1049).", "default": false }, "cat__trucks": { "title": "Trucks", "type": "boolean", "description": "Scrape Trucks listings — broad category (id 16000). Note: overlaps with Dump Trucks and Off-Highway Trucks.", "default": false }, "cat__motor_graders": { "title": "Motor Graders", "type": "boolean", "description": "Scrape Motor Graders listings.", "default": false }, "cat__crawler_loaders": { "title": "Crawler Loaders", "type": "boolean", "description": "Scrape Crawler Loaders listings.", "default": false }, "cat__scrapers": { "title": "Scrapers", "type": "boolean", "description": "Scrape Scrapers listings.", "default": false }, "cat__pipelayers": { "title": "Pipelayers", "type": "boolean", "description": "Scrape Pipelayers listings.", "default": false }, "cat__forestry_equipment": { "title": "Forestry Equipment", "type": "boolean", "description": "Scrape Forestry Equipment listings.", "default": false }, "cat__skidders": { "title": "Skidders", "type": "boolean", "description": "Scrape Skidders (forestry) listings.", "default": false }, "cat__log_loaders": { "title": "Log Loaders", "type": "boolean", "description": "Scrape Log Loaders listings.", "default": false }, "cat__aggregate_equipment": { "title": "Aggregate Equipment", "type": "boolean", "description": "Scrape Aggregate Equipment listings.", "default": false }, "cat__crusher_aggregate": { "title": "Crusher / Aggregate Equipment", "type": "boolean", "description": "Scrape Crusher / Aggregate Equipment listings.", "default": false }, "cat__drills": { "title": "Drills", "type": "boolean", "description": "Scrape Drills listings.", "default": false }, "cat__trenchers_slash_cable_plows": { "title": "Trenchers / Cable Plows", "type": "boolean", "description": "Scrape Trenchers / Cable Plows listings.", "default": false }, "cat__sweepers_slash_broom_equipment": { "title": "Sweepers / Broom Equipment", "type": "boolean", "description": "Scrape Sweepers / Broom Equipment listings.", "default": false }, "cat__asphalt_slash_pavers_slash_concrete_equipment": { "title": "Asphalt / Pavers / Concrete", "type": "boolean", "description": "Scrape Asphalt / Pavers / Concrete Equipment listings.", "default": false }, "cat__generators": { "title": "Generators / Power Systems", "type": "boolean", "description": "Scrape Generators / Power Systems listings.", "default": false }, "cat__air_compressors": { "title": "Air Compressors", "type": "boolean", "description": "Scrape Air Compressors listings.", "default": false }, "cat__pumps": { "title": "Pumps", "type": "boolean", "description": "Scrape Pumps listings.", "default": false }, "cat__construction_attachments": { "title": "Construction Attachments", "type": "boolean", "description": "Scrape Construction Attachments listings.", "default": false }, "cat__dismantled_machines": { "title": "Dismantled Machines", "type": "boolean", "description": "Scrape Dismantled Machines listings.", "default": false }, "extraCategories": { "title": "Extra categories (escape hatch)", "type": "array", "description": "Adds any category not listed above. Format: [{\"name\": \"My Cat\", \"slug\": \"my-slug\", \"id\": 12345}]. Find slug+id in the MT URL: machinerytrader.com/listings/for-sale//", "default": [] }, "maxListings": { "title": "Max listings to download", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Total listings to download across all selected categories; the run stops when it reaches this number. Default 50 keeps the automated/test run fast and cheap. Raise it (prefilled at 200) for a real pull. Set 0 for no limit (bounded only by 'Max pages per category').", "default": 50 }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 1, "maximum": 200, "type": "integer", "description": "Listing pages crawled per category (~28 listings/page). Default 2 for the quick run; prefilled at 10 for users. Imperva allows ~30 per session.", "default": 2 }, "startPage": { "title": "Start page", "minimum": 1, "type": "integer", "description": "First page index (useful to resume a partial snapshot).", "default": 1 }, "proxyType": { "title": "Proxy type", "enum": [ "RESIDENTIAL", "DATACENTER" ], "type": "string", "description": "Proxy type for the run.", "default": "RESIDENTIAL" } } }, "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 } } } } } } } } } }