# MachineryTrader Discovery — US Heavy Equipment (`rastriq/machinerytrader-discovery`) Actor

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.

- **URL**: https://apify.com/rastriq/machinerytrader-discovery.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** Lead generation, E-commerce, Business
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.90 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## MachineryTrader Discovery — US Heavy Equipment Listings

Discover and extract heavy construction equipment listings from **MachineryTrader.com**, one of the largest US marketplaces for used machinery. Select the categories you need and get a clean, structured snapshot of the market.

### What this Actor does

- Crawls every category you enable and collects all listings, page by page.
- Deduplicates listings across categories so each item appears once.
- Returns a normalized record per listing, ready for spreadsheets, BI tools or a database.
- Lets you cap volume for quick tests or run a full-market snapshot.

### Categories covered

Excavators (incl. mini & crawler), wheel loaders, skid steers, dozers, cranes, loader backhoes, telehandlers, forklifts, boom & scissor lifts, off-highway & dump trucks, trucks, motor graders, crawler loaders, scrapers, pipelayers, forestry equipment, skidders, log loaders, aggregate & crusher equipment, drills, trenchers, sweepers, asphalt/paving/concrete equipment, generators, air compressors, pumps, attachments and dismantled machines. You can also add any extra category via the escape-hatch input.

### Input

| Field | Type | Description |
|---|---|---|
| Category toggles | boolean | Enable each equipment category you want to scrape |
| `extraCategories` | array | Add categories not listed in the toggles |
| `maxListings` | integer | Total listings to download across all categories |
| `maxPagesPerCategory` | integer | Pages per category (~28 listings/page) |
| `startPage` | integer | First page index (useful to resume a snapshot) |

> Quick test: enable one category and set `maxListings` to 50.

### Output

Each listing includes make, model, year, price, condition, hours/mileage, category, location, seller, listing URL, images and a snapshot timestamp. See the Output tab for the full field list.

### Use cases

- **Market mapping** — build a complete inventory of US heavy-equipment supply.
- **Price benchmarking** — compare asking prices by make, model, year and category.
- **Lead generation** — identify active dealers and their inventory.
- **Sourcing** — spot acquisition and resale opportunities.

### FAQ

**Can I scrape everything?** Yes — enable all categories and keep the caps high for a full snapshot, or restrict them for a fast sample.

**How often should I run it?** Schedule it daily or weekly to track new inventory and price movements.

### Legal

This Actor collects only publicly available listing data — the same information any visitor can see in a browser. It does not access private, authenticated or personal account data. You are responsible for complying with the website's terms and applicable law.

# Actor input Schema

## `cat__excavators` (type: `boolean`):

Scrape Excavators listings (all types).
## `cat__mini_excavators` (type: `boolean`):

Scrape Mini Excavators listings.
## `cat__crawler_excavators` (type: `boolean`):

Scrape Crawler Excavators listings.
## `cat__wheel_loaders` (type: `boolean`):

Scrape Wheel Loaders listings.
## `cat__skid_steers` (type: `boolean`):

Scrape Skid Steers listings.
## `cat__track_skid_steers` (type: `boolean`):

Scrape Track Skid Steers listings.
## `cat__dozers` (type: `boolean`):

Scrape Dozers listings.
## `cat__cranes` (type: `boolean`):

Scrape Cranes listings.
## `cat__loader_backhoes` (type: `boolean`):

Scrape Loader Backhoes listings.
## `cat__telehandlers_lifts` (type: `boolean`):

Scrape Telehandlers listings.
## `cat__forklifts_lifts` (type: `boolean`):

Scrape Forklifts listings.
## `cat__lifts` (type: `boolean`):

Scrape Lifts (boom/scissor) listings.
## `cat__off_highway_trucks` (type: `boolean`):

Scrape Off-Highway Trucks listings.
## `cat__dump_trucks` (type: `boolean`):

Scrape Dump Trucks listings (id 16014). Note: overlaps with Trucks (16000) and Off-Highway Trucks (1049).
## `cat__trucks` (type: `boolean`):

Scrape Trucks listings — broad category (id 16000). Note: overlaps with Dump Trucks and Off-Highway Trucks.
## `cat__motor_graders` (type: `boolean`):

Scrape Motor Graders listings.
## `cat__crawler_loaders` (type: `boolean`):

Scrape Crawler Loaders listings.
## `cat__scrapers` (type: `boolean`):

Scrape Scrapers listings.
## `cat__pipelayers` (type: `boolean`):

Scrape Pipelayers listings.
## `cat__forestry_equipment` (type: `boolean`):

Scrape Forestry Equipment listings.
## `cat__skidders` (type: `boolean`):

Scrape Skidders (forestry) listings.
## `cat__log_loaders` (type: `boolean`):

Scrape Log Loaders listings.
## `cat__aggregate_equipment` (type: `boolean`):

Scrape Aggregate Equipment listings.
## `cat__crusher_aggregate` (type: `boolean`):

Scrape Crusher / Aggregate Equipment listings.
## `cat__drills` (type: `boolean`):

Scrape Drills listings.
## `cat__trenchers_slash_cable_plows` (type: `boolean`):

Scrape Trenchers / Cable Plows listings.
## `cat__sweepers_slash_broom_equipment` (type: `boolean`):

Scrape Sweepers / Broom Equipment listings.
## `cat__asphalt_slash_pavers_slash_concrete_equipment` (type: `boolean`):

Scrape Asphalt / Pavers / Concrete Equipment listings.
## `cat__generators` (type: `boolean`):

Scrape Generators / Power Systems listings.
## `cat__air_compressors` (type: `boolean`):

Scrape Air Compressors listings.
## `cat__pumps` (type: `boolean`):

Scrape Pumps listings.
## `cat__construction_attachments` (type: `boolean`):

Scrape Construction Attachments listings.
## `cat__dismantled_machines` (type: `boolean`):

Scrape Dismantled Machines listings.
## `extraCategories` (type: `array`):

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/<slug>/<id>
## `maxListings` (type: `integer`):

Total listings to download across all selected categories; the run stops when it reaches this number. <b>Default 50</b> keeps the automated/test run fast and cheap. Raise it (prefilled at 200) for a real pull. Set <code>0</code> for no limit (bounded only by 'Max pages per category').
## `maxPagesPerCategory` (type: `integer`):

Listing pages crawled per category (~28 listings/page). <b>Default 2</b> for the quick run; prefilled at 10 for users. Imperva allows ~30 per session.
## `startPage` (type: `integer`):

First page index (useful to resume a partial snapshot).
## `proxyType` (type: `string`):

Proxy type for the run.

## Actor input object example

```json
{
  "cat__excavators": true,
  "cat__mini_excavators": true,
  "cat__crawler_excavators": false,
  "cat__wheel_loaders": true,
  "cat__skid_steers": true,
  "cat__track_skid_steers": false,
  "cat__dozers": true,
  "cat__cranes": true,
  "cat__loader_backhoes": false,
  "cat__telehandlers_lifts": false,
  "cat__forklifts_lifts": false,
  "cat__lifts": false,
  "cat__off_highway_trucks": false,
  "cat__dump_trucks": false,
  "cat__trucks": false,
  "cat__motor_graders": false,
  "cat__crawler_loaders": false,
  "cat__scrapers": false,
  "cat__pipelayers": false,
  "cat__forestry_equipment": false,
  "cat__skidders": false,
  "cat__log_loaders": false,
  "cat__aggregate_equipment": false,
  "cat__crusher_aggregate": false,
  "cat__drills": false,
  "cat__trenchers_slash_cable_plows": false,
  "cat__sweepers_slash_broom_equipment": false,
  "cat__asphalt_slash_pavers_slash_concrete_equipment": false,
  "cat__generators": false,
  "cat__air_compressors": false,
  "cat__pumps": false,
  "cat__construction_attachments": false,
  "cat__dismantled_machines": false,
  "extraCategories": [],
  "maxListings": 200,
  "maxPagesPerCategory": 10,
  "startPage": 1,
  "proxyType": "RESIDENTIAL"
}
````

# Actor output Schema

## `anio` (type: `string`):

Anio

## `carga` (type: `string`):

Carga

## `categoria` (type: `string`):

Categoria

## `categoria_input_id` (type: `string`):

Categoria input id

## `compania` (type: `string`):

Compania

## `correo` (type: `string`):

Correo

## `envio` (type: `string`):

Envio

## `estado` (type: `string`):

Estado

## `fabric_motor` (type: `string`):

Fabric motor

## `fec_entrega` (type: `string`):

Fec entrega

## `fecha_publicacion` (type: `string`):

Fecha publicacion

## `financiacion` (type: `string`):

Financiacion

## `imagenes` (type: `string`):

Imagenes

## `item_id` (type: `string`):

Item id

## `marca` (type: `string`):

Marca

## `modelo` (type: `string`):

Modelo

## `moneda` (type: `string`):

Moneda

## `num_serie` (type: `string`):

Num serie

## `pais` (type: `string`):

Pais

## `pais_fab` (type: `string`):

Pais fab

## `peso` (type: `string`):

Peso

## `pot_motor` (type: `string`):

Pot motor

## `precio_texto` (type: `string`):

Precio texto

## `premium_listing` (type: `string`):

Premium listing

## `ref_anunciante` (type: `string`):

Ref anunciante

## `ref_anunciante_texto` (type: `string`):

Ref anunciante texto

## `ref_anuncio` (type: `string`):

Ref anuncio

## `renta_dia` (type: `string`):

Renta dia

## `snapshot_at` (type: `string`):

Snapshot at

## `source` (type: `string`):

Source

## `telefono` (type: `string`):

Telefono

## `tiempo_uso` (type: `string`):

Tiempo uso

## `tipo` (type: `string`):

Tipo

## `tipo_motor` (type: `string`):

Tipo motor

## `ubicacion` (type: `string`):

Ubicacion

## `url` (type: `string`):

Url

## `valor` (type: `string`):

Valor

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "cat__excavators": true,
    "cat__mini_excavators": true,
    "cat__wheel_loaders": true,
    "cat__skid_steers": true,
    "cat__dozers": true,
    "cat__cranes": true,
    "maxListings": 200,
    "maxPagesPerCategory": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/machinerytrader-discovery").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "cat__excavators": True,
    "cat__mini_excavators": True,
    "cat__wheel_loaders": True,
    "cat__skid_steers": True,
    "cat__dozers": True,
    "cat__cranes": True,
    "maxListings": 200,
    "maxPagesPerCategory": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/machinerytrader-discovery").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cat__excavators": true,
  "cat__mini_excavators": true,
  "cat__wheel_loaders": true,
  "cat__skid_steers": true,
  "cat__dozers": true,
  "cat__cranes": true,
  "maxListings": 200,
  "maxPagesPerCategory": 10
}' |
apify call rastriq/machinerytrader-discovery --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=rastriq/machinerytrader-discovery",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "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/<slug>/<id>",
                        "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. <b>Default 50</b> keeps the automated/test run fast and cheap. Raise it (prefilled at 200) for a real pull. Set <code>0</code> 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). <b>Default 2</b> 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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
