{ "openapi": "3.0.1", "info": { "title": "Mascus Equipment Scraper", "description": "Scrape used heavy equipment, farm machinery, trucks and forklifts from Mascus: price, make, model, year, hours, condition, dealer contacts. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "FVBrvKqR0DzLwiWgh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~mascus-equipment-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-mascus-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/parseforge~mascus-equipment-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-mascus-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/parseforge~mascus-equipment-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-mascus-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", "properties": { "startUrls": { "title": "🔗 Mascus search URLs", "type": "array", "description": "Category or search result pages copied from Mascus, for example https://www.mascus.com/construction/excavators. Dealer pages (searchdealer.html) load their inventory in the browser and are not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "🔎 Keywords", "type": "array", "description": "Free-text searches run across the whole Mascus catalogue, for example \"volvo ec220\" or \"kubota mini excavator\". Each keyword becomes its own search.", "items": { "type": "string" } }, "categorySlugs": { "title": "📂 Categories", "type": "array", "description": "Scrape whole Mascus categories. Every value is verified against the live catalogue tree: 111 categories across the 6 equipment areas. Each category becomes its own search.", "items": { "type": "string", "enum": [ "agriculture/agriharvesters", "agriculture/atvsmain", "agriculture/cropprocessingmachines", "agriculture/agriothers", "agriculture/fertilizerapplications", "agriculture/foragers", "agriculture/hedgecutters", "agriculture/irrigation", "agriculture/livestockmachinery", "agriculture/loadanddig", "agriculture/oliveharvestingequipment", "agriculture/plantprotection", "agriculture/potatoequipment", "agriculture/roadandsnow", "agriculture/sowingequipment", "agriculture/agrispareparts", "agriculture/sprayers", "agriculture/tillageequipment", "agriculture/agriculturewheels", "agriculture/tractoracc", "agriculture/tractors", "agriculture/agritrailers", "agriculture/wineequipment", "construction/platformsandcranes", "construction/asphaltmachinesmain", "construction/asphaltrecyclers", "construction/constructioncomponents", "construction/backhoeloaders", "construction/compactionequipmentmain", "construction/compressorequipment", "construction/concreteequipment", "construction/constructionothersmain", "construction/constructionhoistsandworkplatforms", "construction/cranesmain", "construction/dozers", "construction/drillingequipmentmain", "construction/dumpersmain", "construction/excavators", "construction/generators", "construction/loaders", "construction/marineequipment", "construction/oilandgasequipment", "construction/pilingequipmentmain", "construction/drillingrigs", "construction/roadconstruction", "construction/rollers", "construction/scaffoldingequipment", "construction/constructionspareparts", "construction/telehandlers", "construction/constructiontyres", "construction/constructiontrenchers", "construction/undergroundminingequipment", "forestry/delimbers", "forestry/fellerbunchers", "forestry/forestryothers", "forestry/forestrycomponents", "forestry/forestexcavators", "forestry/forestrytractors", "forestry/forwarders", "forestry/harvesters", "forestry/harwarders", "forestry/knuckleboomloaders", "forestry/sawmills", "forestry/skidders", "forestry/forestryspareparts", "forestry/forestrytyres", "forestry/woodprocessing", "groundscare/beachcleaningequipment", "groundscare/compacttractorattachments", "groundscare/compacttractors", "groundscare/hedgetrimmers", "groundscare/othergroundscaremachines", "groundscare/groundscareequipment", "groundscare/lawnmowers", "groundscare/pressurewashequipment", "groundscare/groundscarespareparts", "groundscare/sweepers", "groundscare/groundscaretyres", "groundscare/twowheeledtractors", "groundscare/utilitymachines", "groundscare/utilitytoolcarriers", "materialhandling/airportequipment", "materialhandling/materialhandlingcomponents", "materialhandling/containertrucks", "materialhandling/forklifttrucks", "materialhandling/orderpickers", "materialhandling/materialhandlingothers", "materialhandling/pallettrucks", "materialhandling/reachtrucks", "materialhandling/sideloaders", "materialhandling/materialhandlingspareparts", "materialhandling/specialapplicationsmaterialhandling", "materialhandling/stackers", "materialhandling/materialhandlingtyres", "materialhandling/warehouseequipment", "materialhandling/warehousesweepingmachines", "cargo-transport/cars", "cargo-transport/bustrucks", "cargo-transport/cargosuperstructures", "cargo-transport/containers", "cargo-transport/tractortrucksmain", "cargo-transport/crosscountryvehicles", "cargo-transport/loadhandlers", "cargo-transport/cargoothercomponents", "cargo-transport/semitrailers", "cargo-transport/publicservicevehicles", "cargo-transport/cargospareparts", "cargo-transport/cargotyres", "cargo-transport/trailers", "cargo-transport/trucks", "cargo-transport/vans" ], "enumTitles": [ "Agriculture > Agricultural harvesters", "Agriculture > ATVs and Snowmobiles", "Agriculture > Crop processing and storage equipment", "Agriculture > Farm Equipment - Others", "Agriculture > Fertilizer application", "Agriculture > Hay and Forage machines", "Agriculture > Hedge cutters", "Agriculture > Irrigation", "Agriculture > Livestock Machinery", "Agriculture > Loading and digging", "Agriculture > Olive Harvesting Equipment", "Agriculture > Plant protection and irrigating", "Agriculture > Potato Equipment", "Agriculture > Road and Snow Equipment", "Agriculture > Sowing And Planting Machines", "Agriculture > Spare Parts", "Agriculture > Sprayers and Chemical Applicators", "Agriculture > Tillage Machines", "Agriculture > Tires, wheels and rims", "Agriculture > Tractor Accessories", "Agriculture > Tractors", "Agriculture > Trailers", "Agriculture > Wine Growing Equipment", "Construction > Aerial platforms", "Construction > Asphalt Equipment", "Construction > Asphalt Recycling Equipment", "Construction > Attachments", "Construction > Backhoe Loaders", "Construction > Compaction Equipment", "Construction > Compressors", "Construction > Concrete Equipment", "Construction > Construction - Other", "Construction > Construction hoists and work platforms", "Construction > Cranes", "Construction > Dozers", "Construction > Drilling equipment", "Construction > Dump Trucks", "Construction > Excavators", "Construction > Generators", "Construction > Loaders", "Construction > Marine equipment", "Construction > Oil and Gas Equipment", "Construction > Piling equipment", "Construction > Quarry & Waste / Recycling Equipment", "Construction > Road Construction Equipment", "Construction > Rollers", "Construction > Scaffolding Equipment", "Construction > Spare Parts", "Construction > Telescopic Handlers", "Construction > Tires, wheels and rims", "Construction > Trenchers", "Construction > Underground Mining Equipment", "Forestry > Delimbers", "Forestry > Feller Bunchers", "Forestry > Forestry - Others", "Forestry > Forestry Accessories", "Forestry > Forestry Excavators", "Forestry > Forestry Tractors", "Forestry > Forwarders", "Forestry > Harvesters", "Forestry > Harwarders", "Forestry > Knuckleboom loaders", "Forestry > Sawmills", "Forestry > Skidders", "Forestry > Spare Parts", "Forestry > Tires, wheels and rims", "Forestry > Wood processing, chipping and recycling", "Grounds Care > Beach cleaning equipment", "Grounds Care > Compact tractor attachments", "Grounds Care > Compact tractors", "Grounds Care > Flail Cutters", "Grounds Care > Groundcare - Others", "Grounds Care > Groundscare Equipment", "Grounds Care > Lawn mowers", "Grounds Care > Pressure Wash Equipment", "Grounds Care > Spare Parts", "Grounds Care > Sweepers", "Grounds Care > Tires, wheels and rims", "Grounds Care > Two Wheeled Tractors", "Grounds Care > Utility Machines", "Grounds Care > Utility Tool Carriers", "Material Handling > Airport equipment", "Material Handling > Attachment/Components", "Material Handling > Container Trucks", "Material Handling > Forklifts", "Material Handling > Order pickers", "Material Handling > Others", "Material Handling > Pallet Trucks", "Material Handling > Reach trucks", "Material Handling > Side Loaders", "Material Handling > Spare Parts", "Material Handling > Special Applications", "Material Handling > Stackers", "Material Handling > Tires, wheels and rims", "Material Handling > Warehouse Equipment", "Material Handling > Warehouse Sweeping Machines", "Trucks and Transport > Automobiles / SUVS", "Trucks and Transport > Bus / Coach", "Trucks and Transport > Cargo Truck Accessories", "Trucks and Transport > Containers", "Trucks and Transport > Conventional Trucks / Tractor Trucks", "Trucks and Transport > Cross-country vehicles", "Trucks and Transport > Load Handling", "Trucks and Transport > Other Components", "Trucks and Transport > Semi-Trailers", "Trucks and Transport > Service / Utility", "Trucks and Transport > Spare Parts", "Trucks and Transport > Tires, wheels and rims", "Trucks and Transport > Trailers", "Trucks and Transport > Trucks", "Trucks and Transport > Vans" ] } }, "maxItems": { "title": "🔢 Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "market": { "title": "🌍 Market", "enum": [ "www.mascus.com.au", "www.mascus.at", "www.mascus.be", "www.mascus.com.br", "www.mascus.bg", "www.cnmasike.com", "www.mascus.hr", "www.mascus.cz", "www.mascus.dk", "www.mascus.ee", "www.mascus.fi", "www.mascus.fr", "www.mascus.de", "www.mascus.gr", "www.mascus.hu", "www.mascus.ie", "www.mascus.it", "www.mascus.jp", "www.mascus.lv", "www.mascus.lt", "www.mascus.lu", "es.mascus.com", "ar.mascus.com", "www.mascus.me", "www.mascus.nl", "www.mascus.co.nz", "www.mascus.no", "www.mascus.pl", "www.mascus.pt", "www.mascus.ro", "www.mascus.rs", "www.mascus.sk", "www.mascus.si", "www.mascus.co.za", "www.mascus.co.kr", "www.mascus.es", "www.mascus.se", "www.mascus.com.tw", "www.mascus.com.tr", "www.mascus.com.ua", "www.mascus.ua", "www.mascus.co.uk", "www.mascus.com" ], "type": "string", "description": "Mascus runs one inventory behind 43 country sites. The market sets the price currency, the page language and which country is promoted to the top of the results. It does not change how many listings exist.", "default": "www.mascus.com" }, "countries": { "title": "📍 Seller countries", "type": "array", "description": "Keep only machines located in these countries. Leave empty for every country.", "items": { "type": "string", "enum": [ "AL", "AO", "AR", "AM", "AU", "AT", "BS", "BE", "BO", "BA", "BR", "BG", "CM", "CA", "CL", "CN", "CO", "KM", "CR", "HR", "CY", "CZ", "DK", "DO", "EC", "EG", "SV", "EE", "FO", "FI", "FR", "GE", "DE", "GH", "GB", "GR", "GL", "GT", "HN", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IL", "IT", "CI", "JP", "JO", "KG", "LV", "LB", "LI", "LT", "LU", "MK", "MG", "MY", "MX", "MN", "ME", "NA", "NL", "NZ", "NO", "OT", "PA", "PE", "PH", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SE", "CH", "TJ", "TW", "TZ", "TH", "TG", "TN", "TR", "UG", "UA", "AE", "UK", "US", "UY", "UZ" ], "enumTitles": [ "Albania (AL)", "Angola (AO)", "Argentina (AR)", "Armenia (AM)", "Australia (AU)", "Austria (AT)", "Bahamas (BS)", "Belgium (BE)", "Bolivia (BO)", "Bosnia-Herzegovina (BA)", "Brazil (BR)", "Bulgaria (BG)", "Cameroon (CM)", "Canada (CA)", "Chile (CL)", "China (CN)", "Colombia (CO)", "Comoros (KM)", "Costa Rica (CR)", "Croatia (HR)", "Cyprus (CY)", "Czech Republic (CZ)", "Denmark (DK)", "Dominican Republic (DO)", "Ecuador (EC)", "Egypt (EG)", "El Salvador (SV)", "Estonia (EE)", "Faroe Islands (FO)", "Finland (FI)", "France (FR)", "Georgia (GE)", "Germany (DE)", "Ghana (GH)", "Great Britain (GB)", "Greece (GR)", "Greenland (GL)", "Guatemala (GT)", "Honduras (HN)", "Hong Kong (HK)", "Hungary (HU)", "Iceland (IS)", "India (IN)", "Indonesia (ID)", "Iraq (IQ)", "Ireland (IE)", "Israel (IL)", "Italy (IT)", "Ivory Coast (Cote D'Ivoire) (CI)", "Japan (JP)", "Jordan (JO)", "Kyrgyz Republic (KG)", "Latvia (LV)", "Lebanon (LB)", "Liechtenstein (LI)", "Lithuania (LT)", "Luxembourg (LU)", "Macedonia (MK)", "Madagascar (MG)", "Malaysia (MY)", "Mexico (MX)", "Mongolia (MN)", "Montenegro (ME)", "Namibia (NA)", "Netherlands (NL)", "New Zealand (NZ)", "Norway (NO)", "Other (OT)", "Panama (PA)", "Peru (PE)", "Philippines (PH)", "Poland (PL)", "Portugal (PT)", "Puerto Rico (PR)", "Qatar (QA)", "Reunion (French) (RE)", "Romania (RO)", "Russia (RU)", "Saudi Arabia (SA)", "Senegal (SN)", "Serbia (RS)", "Singapore (SG)", "Slovak Republic (SK)", "Slovenia (SI)", "South Africa (ZA)", "South Korea (KR)", "Spain (ES)", "Sri Lanka (LK)", "Sweden (SE)", "Switzerland (CH)", "Tadjikistan (TJ)", "Taiwan (TW)", "Tanzania (TZ)", "Thailand (TH)", "Togo (TG)", "Tunisia (TN)", "Turkey (TR)", "Uganda (UG)", "Ukraine (UA)", "United Arab Emirates (AE)", "United Kingdom (UK)", "United States (US)", "Uruguay (UY)", "Uzbekistan (UZ)" ] } }, "condition": { "title": "🛠 Condition", "enum": [ "", "100", "104", "105", "107", "106", "101", "102_a", "3125", "3124", "3155", "102" ], "type": "string", "description": "Keep only listings the seller tagged with this condition. Most sellers leave it blank, so this filter cuts the result set hard." }, "sortBy": { "title": "↕️ Sort by", "enum": [ "relevance", "createdate_desc", "createdate_asc", "price_asc", "price_desc", "yearofmanufacture_desc", "yearofmanufacture_asc", "meterreadouthours_asc", "meterreadouthours_desc" ], "type": "string", "description": "Order of the results. Flipping the order is the way to reach past the 10,000-listing cap of a single search: run it ascending and descending.", "default": "relevance" }, "listedWithinDays": { "title": "📅 Listed within the last N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep only machines published in the last N days. Leave empty for the full archive." }, "proxyConfiguration": { "title": "🛡 Proxy", "type": "object", "description": "Apify proxy settings.", "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 } } } } } } } } } }