Machinio Used Heavy Equipment Scraper

Here is one real result, with every field the actor returns (description trimmed with an explicit note; all values are real):

{
  "listingId": "85462306",
  "title": "2012 CATERPILLAR 336E",
  "make": "Caterpillar",
  "model": "336E",
  "year": 2012,
  "category": "Construction equipment/Excavators",
  "condition": "used",
  "hours": "10,093 h",
  "price": 79000,
  "priceCurrency": "USD",
  "locationCity": "Seattle",
  "locationState": "WA",
  "locationCountry": "US",
  "dealerName": "Proxy Equipment",
  "imageUrl": "https://i.machinio.com/thumb/c0309a0602eae68d423bdc1286ac65db/original_compressed-front_left_branded/ddf6/2012-caterpillar-336e.jpg",
  "url": "https://www.machinio.com/listings/85462306-2012-caterpillar-336e-in-seattle-wa",
  "source": "Machinio",
  "observedAt": "2026-08-11T12:23:03.363Z",
  "searchQuery": "excavators / Caterpillar",
  "imageCount": 24,
  "serialNumber": null,
  "stockNumber": "JSV0R4W082030",
  "obs": null,
  "description": "CATERPILLAR 336E Excavator, CAT C9.3 Engine, 323HP, Enclosed Cab W/AC, Unit Come With 54\" Dig Bucket, Operating Weight 67236LBS, Unit In Good Working ...[trimmed]",
  "detailLocation": "🇺🇸 Seattle, WA, USA· 2364 mi awayApproximate distance from Franklin, NJ"
}

The detailLocation field is reproduced exactly as Machinio returns it, including the country flag and run-together spacing.

The most complete Machinio used equipment scraper available. It returns every field a Machinio listing exposes (make, model, year, category, condition, hours, price and currency, full location, dealer, and image), plus the full detail add-on (spec-sheet description, serial and stock numbers, image count), and it gives you nine filters (categories, keywords, make, model, country, year range, and price range) to target exactly the machines you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor scrapes used heavy equipment listings from Machinio by category and keyword, applies the filters you pass (make, model, country, year range, price range), and writes one normalized record per listing to the run's dataset. When withDetails is on (the default), it opens each listing for the full spec-sheet description, condition, serial and stock numbers, dealer name, and image count. Prices are returned as numbers with their currency, each listing is tagged with the search that produced it, and missing source values are returned as null.

Data covers used and surplus equipment listed on Machinio across construction, agriculture, transport, and material handling categories worldwide.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 25 Caterpillar excavators with full detail.

{
  "categories": ["excavators"],
  "make": "Caterpillar",
  "withDetails": true,
  "maxListings": 25
}

Provide categories, keywords, or both. Every input is optional; with an empty input the actor uses the prefilled category.

Input reference

Field	Type	Required	Default	Description
categories	string[]	no	["excavators"]	Equipment category slugs to scrape, for example excavators, wheel-loaders, dozers, cranes, dump-trucks, forklifts, tractors. Use the slug as it appears in a Machinio category URL.
keywords	string[]	no	(empty)	Free-text searches run in addition to categories, for example caterpillar 320 or john deere tractor. Each keyword is searched separately.
make	string	no	(empty)	Restrict all searches to a single manufacturer, for example Caterpillar, Komatsu, John Deere, Volvo.
model	string	no	(empty)	Keep only listings whose model or title contains this text, for example 320 or R210.
country	string	no	(empty)	Keep only listings in this ISO-3166 country code, for example US, DE, FR, GB.
yearMin	integer	no	(none)	Keep only listings from this year of manufacture or newer.
yearMax	integer	no	(none)	Keep only listings up to this year of manufacture.
priceMin	integer	no	(none)	Keep only listings priced at or above this amount (in the listing currency).
priceMax	integer	no	(none)	Keep only listings priced at or below this amount (in the listing currency).
withDetails	boolean	no	true	Open each listing page for the full spec sheet, description, condition, serial and stock number, and dealer name. Off returns listing-only rows.
maxListings	integer	no	50	Maximum listings to return across all searches. Free Apify plans are capped at 10 per run.

Filters combine with logical AND and are applied after the listings are fetched.

Output reference

One dataset item per listing. Types: string, integer, or null when the source value is absent.

Field	Type	Description
listingId	string	Machinio listing ID (unique per listing).
title	string	Listing title.
make	string	Manufacturer, or null.
model	string	Model, or null.
year	integer	Year of manufacture, or null.
category	string	Machinio category path, for example Construction equipment/Excavators.
condition	string	Condition, for example used, or null.
hours	string	Operating hours as shown, for example 10,093 h, or null.
price	integer	Listing price, or null when the seller hides it.
priceCurrency	string	Currency code of the price, for example USD, or null.
locationCity	string	Listing city, or null.
locationState	string	Listing state or region, or null.
locationCountry	string	ISO country code of the listing, or null.
dealerName	string	Selling dealer name (detail add-on), or null.
imageUrl	string	Primary listing image URL.
url	string	Canonical Machinio listing URL.
source	string	Always Machinio.
observedAt	string	ISO 8601 timestamp of when the record was collected.
searchQuery	string	The category or keyword search that produced this listing.
imageCount	integer	Number of images on the listing (detail add-on), or null.
serialNumber	string	Machine serial number (detail add-on), or null.
stockNumber	string	Dealer stock number (detail add-on), or null.
obs	string	Additional notes from the spec sheet (detail add-on), or null.
description	string	Full spec-sheet description text (detail add-on), or null.
detailLocation	string	Detailed location line from the listing page (detail add-on), or null.

On a run that matches nothing, the actor writes a single item with a populated error field instead of listing fields.

Example output record

Real record from a live run (input {"categories":["excavators"],"make":"Caterpillar","withDetails":true,"maxListings":12}, description trimmed with a note):

{
  "listingId": "115170215",
  "title": "2024 CATERPILLAR 308 CR",
  "make": "Caterpillar",
  "model": "308 CR",
  "year": 2024,
  "category": "Construction equipment/Excavators",
  "condition": "used",
  "hours": "660 h",
  "price": 125000,
  "priceCurrency": "USD",
  "locationCity": "Rexford",
  "locationState": "MT",
  "locationCountry": "US",
  "dealerName": "56 Truck and Equipment",
  "imageUrl": "https://i.machinio.com/thumb/2zoo4k/256544737/ddf6/2024-caterpillar-308-cr.jpg",
  "url": "https://www.machinio.com/listings/115170215-2024-caterpillar-308-cr-in-rexford-mt",
  "source": "Machinio",
  "observedAt": "2026-08-11T12:23:03.373Z",
  "searchQuery": "excavators / Caterpillar",
  "imageCount": 1,
  "serialNumber": "CAT00308HGG809967",
  "stockNumber": null,
  "obs": null,
  "description": "Manufacturers premier warranty valid until April 5, 2029 or 2,000 hours Features Auxiliary hydraulics, Two-way, Counter weights, Removable, Backfill bl ...[trimmed]",
  "detailLocation": "🇺🇸 Rexford, MT, USA· 1942 mi awayApproximate distance from Pensacola, FL"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~machinio-equipment-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"categories":["excavators"],"make":"Caterpillar","priceMax":150000,"maxListings":50}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~machinio-equipment-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["john deere tractor"],"country":"US","yearMin":2015,"maxListings":100}'

Apify CLI:

apify call scrapers_lat/machinio-equipment-scraper \
  --input '{"categories":["wheel-loaders"],"make":"Komatsu"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per listing returned (result event). See the pricing tab for the current per-result price.
• Details add-on. When withDetails is on, the per-listing detail fetch (description, serial and stock numbers, dealer, image count) is part of each row. Turn it off to pay for listing-only rows.
• No charge on failure. If nothing matches or a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 listings per run. Upgrade for higher maxListings.

FAQ and troubleshooting

A run returned 0 records. Why? Your filters matched no listings. Loosen the year or price range, drop the country or model filter, or try a broader category. Zero-result runs are not charged.

Where do I find category slugs? Use the slug as it appears in a Machinio category URL, for example excavators, wheel-loaders, dozers, cranes, dump-trucks, forklifts, tractors.

Why is price null? The seller lists the machine without a public price (for example "call for price"). Missing source values are returned as null, never invented.

How do I get serial numbers, dealer names, and full specs? Keep withDetails on (the default). Those fields come from opening each listing page.

Can I combine categories and keywords? Yes. Categories and keywords are searched separately and merged, and every listing carries the searchQuery that produced it.

Is this an official Machinio tool? No. This actor is independent and has no affiliation with Machinio. It reads only listings that are publicly available on machinio.com.

Related scrapers

• Aircraft For Sale Scraper: Used aircraft listings with specs and prices.
• Elektra Scraper: Products and prices from Elektra Mexico.
• Walmart Product Scraper: Products and prices from Walmart.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Machinio. Accesses only publicly available listings from machinio.com.