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
Autorisierung
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Abfrageparameter
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.htmlhttps://www.mascus.nl/bouw/graafmachines/nl,country.htmlhttps://www.mascus.de/baumaschinen/bagger/de,country.htmlAlso supported:
https://www.mascus.be/+/catalogs=construction&categories=excavators&countries=BE/1,relevance,search.htmlFilters from the URL are kept on page 2+.
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.
Antworttext
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.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"}