Mascus Search
Search for heavy equipment listings on Mascus by category or search URL, returning paginated results with machine specs, pricing, and seller info.
Credit cost: 1 credit per call
Authorization
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
Full Mascus search or category browse URL for heavy equipment.
Supported domains: .com, .fr, .de, .es, .it, .pl, .nl, .be, .se, .fi, .no, .dk, .pt and all other Mascus country domains.
Example (category browse):
https://www.mascus.fr/engins-de-construction/pelles-sur-chenillesExample (with keyword filter):
https://www.mascus.com/construction/crawler-excavators?q=caterpillar+320Note: Pagination can be added by appending ?page=2 to the URL. All equipment categories are supported (construction, agriculture, trucks, forklifts, cranes, etc.).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/mascus/search?query=string"{
"total": 3482,
"page": 1,
"results": [
{
"id": "xeugf2of",
"title": "Caterpillar 320D",
"url": "https://www.mascus.fr/engins-de-construction/pelles-sur-chenilles/caterpillar-320d/xeugf2of.html",
"category": "Pelles sur chenilles",
"price": {
"amount": 68500,
"currency": "EUR",
"formatted": "68 500 €"
},
"machine": {
"brand": "Caterpillar",
"model": "320D",
"year": 2011,
"hours": 9200,
"condition": "used"
},
"seller": {
"name": "Engins Pro Services",
"type": "dealer",
"country": "FR"
},
"image": "https://static.mascus.com/img/prod/small/xeugf2of_1.jpg",
"location": "Toulouse, France"
},
{
"id": "abcd1234",
"title": "Komatsu PC210-8",
"url": "https://www.mascus.fr/engins-de-construction/pelles-sur-chenilles/komatsu-pc210-8/abcd1234.html",
"category": "Pelles sur chenilles",
"price": {
"amount": 72000,
"currency": "EUR",
"formatted": "72 000 €"
},
"machine": {
"brand": "Komatsu",
"model": "PC210-8",
"year": 2013,
"hours": 11500,
"condition": "used"
},
"seller": {
"name": "MachinesPro SAS",
"type": "dealer",
"country": "FR"
},
"image": "https://static.mascus.com/img/prod/small/abcd1234_1.jpg",
"location": "Lyon, France"
}
]
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}