{ "openapi": "3.0.1", "info": { "title": "Mascus Heavy Equipment Scraper", "description": "Scrape used construction, agriculture, forestry, groundcare, material handling, and transportation equipment listings from Mascus - a global heavy-equipment marketplace. Browse by category, manufacturer, and country, or fetch specific listing URLs.", "version": "1.0", "x-build-id": "5qjyeCXKN2eiUPPZz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~mascus-heavy-equipment-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-mascus-heavy-equipment-scraper", "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/crawlerbros~mascus-heavy-equipment-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-mascus-heavy-equipment-scraper", "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/crawlerbros~mascus-heavy-equipment-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-mascus-heavy-equipment-scraper", "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", "required": [ "mode", "mainCategory" ], "properties": { "mode": { "title": "Mode", "enum": [ "browse", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "browse" }, "mainCategory": { "title": "Equipment type (mode=browse)", "enum": [ "construction", "agriculture", "forestry", "groundcare", "material-handling", "transportation" ], "type": "string", "description": "Top-level equipment category to browse.", "default": "construction" }, "subCategory": { "title": "Specific machine category (mode=browse)", "enum": [ "", "excavators", "crawler-excavators", "wheeled-excavators", "mini-diggers-excavators-7", "demolition-excavators", "backhoe-loaders", "cranes", "rough-terrain-cranes", "all-terrain-cranes", "tracked-cranes", "tower-cranes", "mini-cranes", "aerial-platforms", "articulated-boom-lifts", "telescopic-boom-lifts", "scissor-lifts", "telescopic-handlers", "dumpers", "site-dumpers", "articulated-dump-trucks-(adts)", "rigid-dump-trucks", "loaders", "wheel-loaders", "skid-steer-loaders", "crawler-loaders", "mini-loaders", "dozers", "crawler-dozers", "wheel-dozers", "graders", "scrapers", "trenchers", "compressors", "generator", "diesel-generators", "rollers", "single-drum-rollers", "twin-drum-rollers", "pneumatic-tired-rollers", "drilling-equipment", "asphalt-machines", "asphalt-pavers", "compaction-equipment", "soil-compactors", "plate-compactors", "crushers", "mobile-crushers", "screeners", "concrete-equipment", "concrete-pump-trucks", "piling-rigs", "backhoes", "tractors", "combine-harvesters", "agricultural-harvesters", "forage-harvesters", "self-propelled-foragers", "mowers", "square-balers", "round-balers", "telehandlers-for-agriculture", "front-loaders-and-diggers", "trailers-agriculture", "tipper-trailers", "conventional-ploughs", "cultivators", "disc-harrows", "power-harrows-and-rototillers", "manure-spreaders", "mineral-spreaders", "combination-drills", "planters", "sprayers", "self-propelled-sprayers", "atvs", "utvs", "irrigation-systems", "forestry-harvesters", "forest-excavators", "forwarders", "feller-bunchers", "skidders", "forestry-tractors", "forestry-mulchers", "wood-chippers", "stump-grinders", "sawmills", "knuckleboom-loaders", "chainsaws-and-clearing-saws", "compact-tractors", "lawnmowers", "riding-mowers", "zero-turn-mowers", "walk-behind-mowers", "robot-mowers", "sweepers", "utility-tool-carriers", "golf-carts", "fairway-mowers", "greens-mowers", "two-wheeled-tractors-and-cultivators", "forklift-trucks", "diesel-forklifts", "electric-forklifts", "lpg-forklifts", "pallet-trucks", "stackers", "reach-truck", "order-pickers", "container-handlers", "reachstackers", "terminal-tractors", "overhead-and-gantry-cranes", "automated-guided-vehicles", "narrow-aisle-trucks", "rough-terrain-truck", "sideloader", "scrubber-dryers", "indoor-sweepers", "trucks", "box-body-trucks", "flatbed-dropside-trucks", "tipper-trucks", "crane-trucks", "tank-trucks", "tractor-units", "trailers", "semi-trailers", "flatbed-dropside-semi-trailers", "low-loader-semi-trailers", "tanker-semi-trailers", "box-body-semi-trailers", "tipper-semi-trailers", "timber-semi-trailers", "dollies", "bus-coach", "city-bus", "school-bus", "fire-trucks", "ambulances", "waste-trucks", "recovery-vehicles", "vans-and-light-commercials", "panel-vans", "pick-up-dropside", "motorhomes-and-caravans", "cars", "containers", "shipping-containers", "loader-cranes" ], "type": "string", "description": "The specific machine type to browse (Mascus requires a leaf category; it has no \"browse everything\" page). Leave as \"(Default for equipment type)\" to use a representative category for the chosen equipment type. Must belong to the selected `mainCategory` or 0 results will be returned.", "default": "crawler-excavators" }, "subCategoryOther": { "title": "Custom subcategory slug override (mode=browse)", "type": "string", "description": "Power-user override: an exact Mascus category slug not present in the dropdown above (e.g. `mini-cranes`). Takes precedence over `subCategory` when set." }, "manufacturer": { "title": "Manufacturer (mode=browse)", "enum": [ "", "caterpillar", "cat", "komatsu", "volvo", "hitachi", "doosan", "develon", "hyundai", "kobelco", "liebherr", "jcb", "case", "case_ih", "john_deere", "kubota", "xcmg", "sany", "zoomlion", "sdlg", "liugong", "wacker_neuson", "takeuchi", "new_holland", "yanmar", "bobcat", "terex", "fiat", "mitsubishi", "manitou", "atlas_copco", "bomag", "jlg", "kenworth", "peterbilt", "freightliner", "ford", "fendt", "claas", "massey_ferguson", "valtra", "deutz-fahr", "steyr", "renault", "same", "mccormick", "deutz", "landini", "lamborghini", "mahindra", "agco", "linde", "hyster", "toyota", "yale", "still", "nissan", "clark", "jungheinrich", "konecranes", "kalmar", "hyster-yale", "mercedes-benz", "man", "honda", "kramer", "gehl", "sennebogen", "krone", "kuhn", "kverneland", "vermeer", "scania", "iveco", "daf" ], "type": "string", "description": "Restrict results to a specific manufacturer/brand." }, "manufacturerOther": { "title": "Custom manufacturer slug override (mode=browse)", "type": "string", "description": "Power-user override: an exact Mascus manufacturer slug not present in the dropdown above (e.g. `hidromek`). Takes precedence over `manufacturer` when set." }, "country": { "title": "Country (mode=browse)", "enum": [ "", "us", "ca", "mx", "gb", "de", "fr", "it", "es", "pt", "nl", "be", "lu", "ch", "at", "se", "no", "dk", "fi", "is", "ie", "pl", "cz", "sk", "hu", "ro", "bg", "gr", "hr", "si", "rs", "ba", "mk", "al", "me", "xk", "ee", "lv", "lt", "by", "ua", "md", "ru", "tr", "cy", "mt", "au", "nz", "jp", "kr", "cn", "in", "id", "my", "sg", "th", "vn", "ph", "pk", "bd", "lk", "ae", "sa", "qa", "kw", "bh", "om", "il", "jo", "lb", "iq", "ir", "eg", "za", "ng", "ke", "gh", "ma", "dz", "tn", "ci", "sn", "br", "ar", "cl", "co", "pe", "uy", "py", "bo", "ec", "ve", "cr", "pa", "do", "gt", "hn", "ni", "sv", "jm", "tt", "kz", "uz", "ge", "am", "az" ], "type": "string", "description": "Restrict results to equipment located in a specific country." }, "sortBy": { "title": "Sort order (mode=browse)", "enum": [ "relevance", "price_asc", "price_desc", "year_desc", "year_asc", "date_desc" ], "type": "string", "description": "Result ordering. Only applies when browsing without a manufacturer/country facet (those cap at the first results page).", "default": "relevance" }, "keyword": { "title": "Keyword filter", "type": "string", "description": "Only keep listings whose title or description contains this text (case-insensitive substring match, applied after fetching)." }, "yearMin": { "title": "Year built (min)", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Drop listings manufactured before this year." }, "yearMax": { "title": "Year built (max)", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Drop listings manufactured after this year." }, "priceMin": { "title": "Price (min, USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop listings priced below this amount. Listings without a published price always pass through." }, "priceMax": { "title": "Price (max, USD)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop listings priced above this amount. Listings without a published price always pass through." }, "hoursMax": { "title": "Max operating hours", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Drop listings with more recorded operating hours than this. Listings without hours data always pass through." }, "listingUrls": { "title": "Listing URLs (mode=byUrl)", "type": "array", "description": "Direct Mascus listing URLs to fetch, e.g. `https://www.mascus.com/construction/crawler-excavators/cat-336fl/6sft3pih.html`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 40 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Mascus serves plain HTML with no bot protection, so a proxy is not required, but AUTO datacenter proxy can help avoid rate limiting on large runs.", "default": { "useApifyProxy": 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 } } } } } } } } } }