{
"openapi": "3.0.1",
"info": {
"title": "MachineryTrader Scraper — US Heavy Equipment Listings",
"description": "Scrape heavy equipment listings from MachineryTrader.com, a top US marketplace for construction, agriculture, and forestry machinery. Extract price, make, model, year, hours, dealer info, specs, and photos. Ideal for equipment valuation, market intelligence, and dealer analysis.",
"version": "2.0",
"x-build-id": "qS4dOT0fTcLPgVqcR"
},
"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": {
"data_freshness": {
"title": "📡 Data source",
"enum": [
"preloaded",
"live"
],
"type": "string",
"description": "Preloaded: instant access to our pre-scraped monthly snapshot. Data arrives in seconds.
Live: fresh scrape of MachineryTrader in real time.",
"default": "preloaded"
},
"country": {
"title": "Market",
"enum": [
"us",
"europe",
"es",
"it",
"de",
"fr"
],
"type": "string",
"description": "US covers machinerytrader.com. Europe covers the shared EU catalog (IT/ES/DE/FR — same inventory).",
"default": "us"
},
"scrape_all": {
"title": "All categories",
"type": "boolean",
"description": "Scrape every equipment category. When off, pick individual categories below.",
"default": false
},
"cat__excavators": {
"title": "Excavators",
"type": "boolean",
"description": "All excavator types.",
"default": true
},
"cat__mini_excavators": {
"title": "Mini Excavators",
"type": "boolean",
"description": "Compact/mini excavators.",
"default": false
},
"cat__crawler_excavators": {
"title": "Crawler Excavators",
"type": "boolean",
"description": "Crawler excavators.",
"default": false
},
"cat__wheel_loaders": {
"title": "Wheel Loaders",
"type": "boolean",
"description": "Wheel loaders.",
"default": false
},
"cat__skid_steers": {
"title": "Skid Steers",
"type": "boolean",
"description": "Skid steer loaders.",
"default": false
},
"cat__track_skid_steers": {
"title": "Track Skid Steers",
"type": "boolean",
"description": "Compact track loaders.",
"default": false
},
"cat__dozers": {
"title": "Dozers",
"type": "boolean",
"description": "Bulldozers.",
"default": false
},
"cat__cranes": {
"title": "Cranes",
"type": "boolean",
"description": "All crane types.",
"default": false
},
"cat__loader_backhoes": {
"title": "Loader Backhoes",
"type": "boolean",
"description": "Loader backhoes.",
"default": false
},
"cat__telehandlers_lifts": {
"title": "Telehandlers",
"type": "boolean",
"description": "Telehandlers.",
"default": false
},
"cat__forklifts_lifts": {
"title": "Forklifts",
"type": "boolean",
"description": "Forklifts.",
"default": false
},
"cat__lifts": {
"title": "Lifts",
"type": "boolean",
"description": "Boom and scissor lifts.",
"default": false
},
"cat__off_highway_trucks": {
"title": "Off-Highway Trucks",
"type": "boolean",
"description": "Off-highway trucks.",
"default": false
},
"cat__dump_trucks": {
"title": "Dump Trucks",
"type": "boolean",
"description": "Dump trucks.",
"default": false
},
"cat__trucks": {
"title": "Trucks",
"type": "boolean",
"description": "General trucks category.",
"default": false
},
"cat__motor_graders": {
"title": "Motor Graders",
"type": "boolean",
"description": "Motor graders.",
"default": false
},
"cat__crawler_loaders": {
"title": "Crawler Loaders",
"type": "boolean",
"description": "Crawler loaders.",
"default": false
},
"cat__scrapers": {
"title": "Scrapers",
"type": "boolean",
"description": "Scrapers.",
"default": false
},
"cat__pipelayers": {
"title": "Pipelayers",
"type": "boolean",
"description": "Pipelayers.",
"default": false
},
"cat__forestry_equipment": {
"title": "Forestry Equipment",
"type": "boolean",
"description": "Forestry equipment.",
"default": false
},
"cat__skidders": {
"title": "Skidders",
"type": "boolean",
"description": "Forestry skidders.",
"default": false
},
"cat__log_loaders": {
"title": "Log Loaders",
"type": "boolean",
"description": "Log loaders.",
"default": false
},
"cat__aggregate_equipment": {
"title": "Aggregate Equipment",
"type": "boolean",
"description": "Aggregate equipment.",
"default": false
},
"cat__crusher_aggregate": {
"title": "Crushers",
"type": "boolean",
"description": "Crushers and aggregate equipment.",
"default": false
},
"cat__drills": {
"title": "Drills",
"type": "boolean",
"description": "Drills.",
"default": false
},
"cat__trenchers_slash_cable_plows": {
"title": "Trenchers / Cable Plows",
"type": "boolean",
"description": "Trenchers and cable plows.",
"default": false
},
"cat__sweepers_slash_broom_equipment": {
"title": "Sweepers",
"type": "boolean",
"description": "Sweepers and broom equipment.",
"default": false
},
"cat__asphalt_slash_pavers_slash_concrete_equipment": {
"title": "Asphalt / Pavers / Concrete",
"type": "boolean",
"description": "Asphalt, pavers, and concrete equipment.",
"default": false
},
"cat__generators": {
"title": "Generators",
"type": "boolean",
"description": "Generators and power systems.",
"default": false
},
"cat__air_compressors": {
"title": "Air Compressors",
"type": "boolean",
"description": "Air compressors.",
"default": false
},
"cat__pumps": {
"title": "Pumps",
"type": "boolean",
"description": "Pumps.",
"default": false
},
"cat__construction_attachments": {
"title": "Attachments",
"type": "boolean",
"description": "Construction attachments.",
"default": false
},
"cat__dismantled_machines": {
"title": "Dismantled Machines",
"type": "boolean",
"description": "Dismantled machines (parts).",
"default": false
},
"manufacturer": {
"title": "Manufacturer / Brand",
"type": "string",
"description": "Filter by manufacturer (e.g. CATERPILLAR, JOHN DEERE, KOMATSU). Leave empty for all brands."
},
"model": {
"title": "Model",
"type": "string",
"description": "Filter by model (e.g. 320, D6, WA380). Requires a manufacturer to be set. Leave empty for all models."
},
"maxListings": {
"title": "Max listings",
"minimum": 0,
"maximum": 500000,
"type": "integer",
"description": "Maximum number of listings to download across all categories. Set 0 for unlimited.",
"default": 50
},
"pricedOnly": {
"title": "Only listings with price",
"type": "boolean",
"description": "Skip listings marked as 'Call for price'. Typically reduces volume by ~25%.",
"default": false
},
"maxPagesPerCategory": {
"title": "Max pages per category",
"minimum": 1,
"maximum": 999,
"type": "integer",
"description": "Each page contains ~28 listings. Higher values give more coverage per category.",
"default": 2
},
"outputSchema": {
"title": "Output schema",
"enum": [
"english",
"ftp28"
],
"type": "string",
"description": "Select 'ftp28' to output canonical Spanish field names required for FTP-28 pipeline integration.",
"default": "english"
},
"_admin_snapshot": {
"title": "Admin snapshot",
"type": "boolean",
"description": "Internal: trigger full snapshot to Named Dataset.",
"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
}
}
}
}
}
}
}
}
}
}