Skip to main content
Network status
Log in
Piloterr
Back to library

Mascus Search API

Search used equipment listings on Mascus from a category URL, with pagination that keeps country and category filters.

Active1 credit = 1 requestGET/v2/mascus/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Mascus Search endpoint returns used equipment listings from a Mascus category URL: brand, model, year, price, location, seller and image.

Pass a full Mascus browse or search URL. Use page (or ?page= in the URL) to paginate, about 40 results per page. Category and country filters from the URL are kept on every page.

Costs 1 credit per call.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/mascus/search?query=https://www.mascus.be/bouw/graafmachines/be,country.html
GET https://api.piloterr.com/v2/mascus/search?query=https://www.mascus.be/bouw/graafmachines/be,country.html&page=2
GET https://api.piloterr.com/v2/mascus/search?query=https://www.mascus.nl/bouw/graafmachines/nl,country.html&page=2
GET https://api.piloterr.com/v2/mascus/search?query=https://www.mascus.de/baumaschinen/bagger/de,country.html&page=2

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full Mascus category/search URL
page integer no Page number (default 1, ~40 results per page)

Recommended URL shapesLink to Recommended URL shapes

Shape Example Notes
Classic country browse https://www.mascus.be/bouw/graafmachines/be,country.html Best for harvests; page / ?page= keep filters
Filter search path https://www.mascus.be/+/catalogs=construction&categories=excavators&countries=BE/2,relevance,search.html Page is in the path (/2,relevance,search.html)

Response fieldsLink to Response fields

Field Type Description
results array Listings on the page
results[].product_id string Listing id
results[].brand / model string Machine brand and model
results[].year_of_manufacture integer Year
results[].price_euro / price_in_user_currency number Price (0 often means on request)
results[].location_city / location_country_code string Location
results[].company_name string Seller
results[].url string Listing URL (use with Mascus Ad)
results[].image_url string Main image
pagination object current, page_size, total_pages, has_next_page, total_results, next

Error codesLink to Error codes

Code Meaning
400 Missing query or invalid Mascus domain
404 Page not found
500 Temporary failure

NotesLink to Notes

  • Prefer classic …/{country},country.html URLs for stable pagination
  • page=2 and query=…?page=2 both work
  • On a filtered URL, total_results stays in the filtered set (not the site-wide catalog)

Related endpointsLink to Related endpoints

  • Mascus Ad: full listing details from a result URL

Related APIs

Expand your data capabilities with these complementary tools.

View All
Mascus Ad/v2/mascus/ad

Get full details for a Mascus used equipment listing: specs, price, seller and description.

GET1 credit = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert