# Mascus Scraper — Used Machinery Listings & Price Monitor (`crawloop/mascus-scraper`) Actor Scrape Mascus used machinery listings: asking prices, make/model/year, hours, dealer phones when published, and images. Browse by category, brand, or country. Details mode adds serials and specs. Monitor new listings and price changes. - **URL**: https://apify.com/crawloop/mascus-scraper.md - **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.29 / 1,000 scraped mascus listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ## Mascus Scraper — Used Machinery Listings & Price Monitor > **Crawloop Used Machinery Marketplace Suite** — Global classifieds for construction, agriculture, forestry, trucks, and material handling. Pair with US Sandhills boards and EU dealer sites for cross-market comps. | Agriaffaires | TractorHouse | Machineryline | Nettikone | | :--- | :--- | :--- | :--- | | [Agriaffaires Scraper](https://apify.com/crawloop/agriaffaires-scraper) | [TractorHouse Scraper](https://apify.com/crawloop/tractorhouse-scraper) | [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper) | [Nettikone Scraper](https://apify.com/crawloop/nettikone-scraper) | | Agrofy | Mascus | Traktorpool | Landwirt | | :--- | :--- | :--- | :--- | | [Agrofy Scraper](https://apify.com/crawloop/agrofy-scraper) | Mascus Scraper ◄── you are here | [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper) | [Landwirt Scraper](https://apify.com/crawloop/landwirt-scraper) | > **Disclaimer:** Unofficial tool — not affiliated with, sponsored by, or endorsed by Mascus, Ritchie Bros., or their brands. Data is read from publicly accessible pages only. You are responsible for complying with applicable law and site terms. No warranty on accuracy or availability. ### What this Mascus scraper does Extract **Mascus** used machinery listings into clean JSON on Apify: asking price (local + EUR), make, model, year, hours, location, images, and dealer phone when the card publishes one. Built for equipment dealers, fleet buyers, appraisers, and data teams who need a **Mascus API alternative** in **Python**, **Node.js**, or **MCP** workflows. Use `listings` for fast catalog cards or `details` to open each PDP for serial number, gallery, company website, and spec fields when Mascus shows them. Enable **`monitorMode`** with an Apify Schedule to track **new listings** and **price changes** on category, brand, or country browse URLs. Parent categories work (`/construction/excavators`). Brand and country browse URLs paginate. Year, price, hours, and `searchQuery` drop rows **before charge** — they are not Mascus search-index filters. ### When to use - Dealer competitive intelligence — watch CAT excavators in Germany or a category daily - Asking-price comps for crawler excavators, wheel loaders, tractors, trucks, forklifts, and forestry machines - Fleet sourcing by manufacturer, model, hours, or country - Outreach lists from listing cards that already publish a dealer phone - Join global Mascus asking prices with US stock from [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) or EU contacts from [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper) For US dealer boards, use [MachineryTrader](https://apify.com/crawloop/machinerytrader-scraper). For European farm classifieds, use [Agriaffaires Scraper](https://apify.com/crawloop/agriaffaires-scraper). For auctions, use [Ritchie Bros Scraper](https://apify.com/crawloop/rbauction-scraper). **Not in scope:** posting ads, Mascus login, dealer-profile inventory pages (Mascus loads those in the browser), site-wide keyword search, spare-parts sites on other domains, or a preloaded monthly snapshot dump. ### Global classifieds workflow ``` Global asking prices Regional / auction enrichment ──────────────────── ──────────────────────────── Mascus Scraper ◄── you are here ──► worldwide classifieds + phones │ category / brand / country + monitor deltas ▼ MachineryTrader Scraper ──────────► US dealer inventory Machineryline Scraper ────────────► EU heavy equipment + contacts Agriaffaires / Nettikone ─────────► farm classifieds Ritchie Bros / IronPlanet ────────► auction lots Join by make + model + year ──► comps, remarketing, residual checks ``` ### Key features - **URL or filters** — paste a category / brand / country / listing URL, or build one from `mainCategory`, `subcategory`, `manufacturer`, and `country` - **Parent categories** — `/construction/excavators` returns listings; you do not have to pick a single leaf type - **Pagination** — category, brand, and country browse URLs continue past page 1 - **Two modes** — `listings` (card price, hours, EUR, phone when published) and `details` (PDP serial, gallery, specs, company website when published) - **Filters before charge** — `searchQuery` (substring on brand/model/title), year, price, hours, advert type, and `pricedOnly` - **Monitor mode** — seed fingerprints on a browse URL, then emit only `new` / `price_change` rows; optional Telegram alerts - **HTTP-first** — `curl_cffi` Chrome TLS; Apify Residential recommended at scale ### Input | Field | Type | Default | Description | | :--- | :--- | :--- | :--- | | `startUrls` | Array | crawler excavators sample | Category, brand, country, or listing detail URLs | | `searchQuery` | String | — | Keep rows whose brand/model/title contain these words | | `mainCategory` | String | — | `construction`, `agriculture`, `forestry`, `groundcare`, `material-handling`, `transportation` | | `subcategory` | String | — | Slug such as `crawler-excavators` or `tractors` | | `manufacturer` | String | — | Brand slug or name (`cat`, `komatsu`, `john_deere`) | | `country` | String | — | ISO2 code (`de`, `us`, `nl`) | | `sort` | String | `relevance` | `relevance`, `date`, `priceasc`, `pricedesc` | | `advertType` | String | `all` | `all`, `sale`, `auction`, `rent` | | `yearMin` / `yearMax` | Integer | — | Year-of-manufacture window | | `priceMin` / `priceMax` | Integer | — | Asking-price window in listing currency | | `hoursMax` | Integer | — | Maximum operating hours | | `runMode` | String | `listings` | `listings` or `details` | | `pricedOnly` | Boolean | `false` | Keep only rows with a published price | | `maxItems` | Integer | `50` | Emit budget (seed run: fingerprint budget) | | `maxPagesPerUrl` | Integer | `10` | Pages per start URL (~40 listings/page) | | `monitorMode` | Boolean | `false` | Delta tracking via named KV store | | `monitorStoreName` | String | `mascus-monitor-state` | Distinct name per watch target | | `proxyConfiguration` | Object | Residential prefill | Apify proxy settings | Provide `startUrls` and/or category filters. If everything is empty, the Actor defaults to construction excavators. #### Input example ```json { "startUrls": [ { "url": "https://www.mascus.com/construction/crawler-excavators" } ], "runMode": "listings", "maxItems": 50, "maxPagesPerUrl": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` Built URL for the same filters without `startUrls`: ```json { "mainCategory": "construction", "subcategory": "crawler-excavators", "manufacturer": "cat", "country": "de", "runMode": "listings", "maxItems": 50 } ``` #### Monitor mode example (Schedule + Telegram) ```json { "startUrls": [ { "url": "https://www.mascus.com/construction/crawler-excavators/cat" } ], "runMode": "listings", "monitorMode": true, "monitorStoreName": "mascus-monitor-cat-excavators", "maxItems": 200, "maxPagesPerUrl": 10, "telegramToken": "123456:ABC...", "telegramChatId": "123456789" } ``` ### Output Each dataset row is one listing. Cards typically include hours, EUR, and a dealer phone when Mascus shows them. Details mode adds serial, gallery, specs, and company website when those fields are on the PDP. | Field | Description | | :--- | :--- | | `id` | Short listing slug from the URL | | `url` | Canonical listing URL | | `title` / `brand` / `model` / `year` | Equipment identity | | `hours` | Operating hours when published | | `price` / `currency` / `priceEur` | Asking price and Mascus EUR conversion | | `location` / `country` | City and ISO country | | `sellerName` / `sellerPhone` / `sellerUrl` | Dealer company fields | | `images` / `imageCount` | Photo URLs | | `isAuction` / `isRental` | Advert type flags | | `serialNumber` / `stockNumber` | PDP identifiers (details) | | `sellerWebsite` / `sellerAddress` / `specs` | PDP enrichment (details) | | `changeType` | `new` or `price_change` in monitor mode | ```json { "id": "4t3pgmip", "url": "https://www.mascus.com/construction/crawler-excavators/cat-308cr/4t3pgmip.html", "title": "CAT 308CR", "brand": "CAT", "model": "308CR", "year": 2020, "hours": 3179, "price": 77900, "currency": "USD", "priceEur": 66901, "country": "US", "location": "Simpsonville, SC, US", "sellerName": "Blanchard Machinery Co.", "sellerPhone": "+18034658080", "isAuction": false, "recordType": "listing" } ``` ### Use cases - **Price intelligence** — pull CAT / Komatsu / Volvo excavator asking prices by country and compare with US MachineryTrader comps - **Dealer watch** — schedule a brand or category URL and get Telegram alerts on new ads and price cuts - **Sourcing** — filter by year, hours, and priced-only rows for fleet replacement - **Lead lists** — export dealer phones and profile URLs from cards that publish them - **MCP / AI** — ask an assistant to run this Actor and return JSON for a model + country ### Integration examples #### Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('crawloop/mascus-scraper').call({ startUrls: [{ url: 'https://www.mascus.com/construction/crawler-excavators' }], runMode: 'listings', maxItems: 50, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items.slice(0, 5)); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient(token) run = client.actor("crawloop/mascus-scraper").call( run_input={ "startUrls": [{"url": "https://www.mascus.com/construction/crawler-excavators"}], "runMode": "listings", "maxItems": 50, } ) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items[:5]) ``` #### cURL ```bash curl "https://api.apify.com/v2/acts/crawloop~mascus-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d "{\"startUrls\":[{\"url\":\"https://www.mascus.com/construction/crawler-excavators\"}],\"runMode\":\"listings\",\"maxItems\":50}" ``` ### MCP and AI assistants Use this Actor from AI tools via [Apify MCP](https://docs.apify.com/platform/integrations/mcp). Connect your Apify account, then call this Actor by its Store ID / name. Example prompts: - "Run Mascus Scraper for CAT crawler excavators in Germany and return the top 20 rows as JSON" - "Monitor new Mascus listings for construction excavators and list any price changes since the last run" - "Scrape Mascus details for this listing URL and return the fields that are on the page (hours, serial, dealer phone, images)" ### Suite next step After a Mascus catalog pull, run [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) for US dealer asking prices on the same make/model, [Agriaffaires Scraper](https://apify.com/crawloop/agriaffaires-scraper) or [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper) for European farm comps, or [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper) for European dealer contacts. For auction comps, use [Ritchie Bros Scraper](https://apify.com/crawloop/rbauction-scraper). ### FAQ **Is this an official Mascus API?** No. It reads public listing pages. There is no official public Mascus API for third-party catalog dumps. **Do I have to pick a leaf category?** No. Parent pages such as `/construction/excavators` return listings. You can also pass a leaf slug (`crawler-excavators`) or a brand URL. **Why are year/price/hours applied after fetch?** Mascus encodes those facets in the UI, not in stable indexable URLs. The Actor still **does not charge** for rows dropped by those filters. **Does monitor mode spam the dataset?** The first scheduled run only stores fingerprints. Later runs emit `new` and `price_change` rows only. **Can I crawl a dealer profile URL?** No. Pages like `/…,searchdealer.html` do not put inventory into the HTML the Actor reads. Watch a category, brand, or country URL instead. **Can I scrape every country TLD?** You can paste a regional host in `startUrls`. Built browse URLs default to `https://www.mascus.com`. ### Related Actors - [Agriaffaires Scraper](https://apify.com/crawloop/agriaffaires-scraper) — European farm classifieds - [TractorHouse Scraper](https://apify.com/crawloop/tractorhouse-scraper) — US + EU Sandhills farm equipment - [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper) — EU heavy equipment and company contacts - [Nettikone Scraper](https://apify.com/crawloop/nettikone-scraper) — Finnish used machinery - [Agrofy Scraper](https://apify.com/crawloop/agrofy-scraper) — Brazil + Argentina farm marketplace - [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper) — DACH / Central Europe farm machinery - [Landwirt Scraper](https://apify.com/crawloop/landwirt-scraper) — AT/DE agrar classifieds + dealer machinery - [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) — US heavy equipment dealer inventory - [Truck1 Scraper](https://apify.com/crawloop/truck1-scraper) — European trucks - [Ritchie Bros Scraper](https://apify.com/crawloop/rbauction-scraper) — auction lots - [Machinio Scraper](https://apify.com/crawloop/machinio-scraper) — global machinery aggregator # Actor input Schema ## `startUrls` (type: `array`): Mascus category, brand, country, or listing detail URLs. Parent categories work (e.g. /construction/excavators). Dealer profile pages do not expose inventory in HTML. Example: https://www.mascus.com/construction/crawler-excavators ## `searchQuery` (type: `string`): Keep listings whose brand, model, or title contain these words (applied after fetch, before charge). Example: 336 or Volvo EC. ## `mainCategory` (type: `string`): Builds a browse URL when startUrls is empty. Parent listing pages are used (not /main-category hubs). ## `subcategory` (type: `string`): Optional leaf or parent slug (e.g. crawler-excavators, excavators, tractors, forklift-trucks). Combined with mainCategory. ## `manufacturer` (type: `string`): Brand slug or name for a built browse URL (e.g. cat, komatsu, john\_deere). Full pagination is kept — unlike Store competitors that cap faceted crawls at page 1. ## `country` (type: `string`): ISO 3166-1 alpha-2 code for a built browse URL (e.g. de, us, nl). Uses Mascus /{cc},country.html paths so pagination continues past page 1. ## `sort` (type: `string`): Result order for paginated browse URLs. ## `advertType` (type: `string`): Keep sale, auction, or rental listings. Applied after fetch, before charge. ## `yearMin` (type: `integer`): Drop listings older than this year when year is published. Applied before charge. ## `yearMax` (type: `integer`): Drop listings newer than this year when year is published. Applied before charge. ## `priceMin` (type: `integer`): Drop priced listings below this amount. Listings without a price pass unless pricedOnly is set. ## `priceMax` (type: `integer`): Drop priced listings above this amount. Listings without a price pass unless pricedOnly is set. ## `hoursMax` (type: `integer`): Drop listings with more hours than this when hours are published. ## `pricedOnly` (type: `boolean`): Skip rows with no published asking price. ## `baseUrl` (type: `string`): Origin for built browse URLs. Default English mascus.com. Regional hosts in startUrls are kept as-is. ## `runMode` (type: `string`): listings = card fields (price, hours, phone when the card publishes one). details = open each PDP for serial, gallery, company website, and specs when shown. ## `maxItems` (type: `integer`): Maximum dataset rows to emit (in monitor seed runs: max listings to fingerprint). ## `maxPagesPerUrl` (type: `integer`): Maximum pagination pages per category / brand / country URL (40 listings per page). ## `concurrencyLimit` (type: `integer`): Parallel PDP fetches in details mode. ## `proxyConfiguration` (type: `object`): Apify Residential Proxies recommended for stable runs at scale. ## `monitorMode` (type: `boolean`): Delta tracking for category, brand, or country URLs. First run seeds a named Key-Value store (no dataset rows / alerts). Later runs output only new listings and price changes. Pair with an Apify Schedule. ## `monitorStoreName` (type: `string`): Named Key-Value store for fingerprints across scheduled runs. Use a distinct name per watch target (category, brand, or country). ## `telegramToken` (type: `string`): Bot token for real-time alerts on new listings and price changes (monitorMode only). Create a bot via @BotFather. ## `telegramChatId` (type: `string`): Telegram user or group chat ID that receives monitor alerts. ## `resetMonitorState` (type: `boolean`): Clear stored listing fingerprints before this run (forces a fresh seed run). ## Actor input object example ```json { "startUrls": [ { "url": "https://www.mascus.com/construction/crawler-excavators" } ], "searchQuery": "336", "subcategory": "crawler-excavators", "manufacturer": "cat", "country": "de", "sort": "relevance", "advertType": "all", "pricedOnly": false, "baseUrl": "https://www.mascus.com", "runMode": "listings", "maxItems": 50, "maxPagesPerUrl": 10, "concurrencyLimit": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "monitorMode": false, "monitorStoreName": "mascus-monitor-state", "resetMonitorState": false } ``` # Actor output Schema ## `results` (type: `string`): Default dataset items: Mascus listings with prices, hours, optional dealer phones, and optional PDP serials and specs. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.mascus.com/construction/crawler-excavators" } ], "baseUrl": "https://www.mascus.com", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "monitorStoreName": "mascus-monitor-state" }; // Run the Actor and wait for it to finish const run = await client.actor("crawloop/mascus-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.mascus.com/construction/crawler-excavators" }], "baseUrl": "https://www.mascus.com", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, "monitorStoreName": "mascus-monitor-state", } # Run the Actor and wait for it to finish run = client.actor("crawloop/mascus-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.mascus.com/construction/crawler-excavators" } ], "baseUrl": "https://www.mascus.com", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "monitorStoreName": "mascus-monitor-state" }' | apify call crawloop/mascus-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawloop/mascus-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/b8TtDPa2OvaPa4Ncf/builds/0Ebvd4WZZOaeEELva/openapi.json