Piloterr

Mascus Search

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

Credit cost: 1 credit per call

GET
/v2/mascus/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full Mascus category or search URL. The country site comes from the host (mascus.be, mascus.nl, mascus.de, mascus.com, …).

Recommended (pagination keeps category + country):

https://www.mascus.be/bouw/graafmachines/be,country.html
https://www.mascus.nl/bouw/graafmachines/nl,country.html
https://www.mascus.de/baumaschinen/bagger/de,country.html

Also supported:

https://www.mascus.be/+/catalogs=construction&categories=excavators&countries=BE/1,relevance,search.html

Filters from the URL are kept on page 2+.

page?number

Page number (default: 1). About 40 results per page.

Example: 2

Works with classic country browse URLs (…/be,country.html) and +/catalogs=…/N,relevance,search.html URLs. You can also put ?page=2 in the query URL.

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"
{
  "results": [
    {
      "url": "https://www.mascus.be/bouw/minigraafmachines---7t/airman-ax10u-7-ax10u-7/ff3ch5ch.html",
      "brand": "Airman",
      "model": "AX10U-7",
      "image_url": "https://dnge9sb91helb.cloudfront.net/image/product/medium/example.jpg",
      "rental_ad": false,
      "auction_ad": false,
      "price_euro": 0,
      "product_id": "{example}",
      "catalog_name": "construction",
      "company_name": "Example Dealer",
      "category_name": "miniexcavators",
      "location_city": "Oostrozebeke",
      "user_currency": "EUR",
      "year_of_manufacture": 2020,
      "location_country_code": "BE",
      "price_in_user_currency": 0
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "page_size": 40,
    "total_pages": 14,
    "has_next_page": true,
    "total_results": 547
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}