troostwijkauctions.com APIwww.troostwijkauctions.com ↗
Search auction lots and retrieve full lot details from Troostwijk Auctions including bids, specs, images, and location via a simple REST API.
curl -X GET 'https://api.parse.bot/scraper/fbcfbbed-b376-4eb3-a263-540b20e4dc86/search_lots' \ -H 'X-API-Key: $PARSE_API_KEY'
Search auction lots by keyword with optional country filter and sorting. Returns paginated results including lot title, bidding status, current bid, location, and images.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search term to find lots (e.g. 'excavator', 'tractor', 'forklift'). |
| country | string | Two-letter country code to filter results (e.g. 'nl', 'be', 'de', 'fr', 'at'). Omitting returns results from all countries. |
| sort_by | string | Field to sort results by. Accepted value: 'endDate'. Omitting sorts by relevance. |
| language | string | Language for search results. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |
| page_size | integer | Number of results per page. |
| sort_direction | string | Sort direction. Accepted values: 'asc', 'desc'. Used with sort_by. |
{
"type": "object",
"fields": {
"page": "integer",
"total": "integer",
"results": "array of lot summaries with id, display_id, title, location, images, bids_count, current_bid_amount_cents, currency, bidding_status, slug",
"has_next": "boolean",
"page_size": "integer"
},
"sample": {
"page": 1,
"total": 780,
"results": [
{
"id": "e4535e58-3098-4895-b4a8-51ab92c12dcd",
"slug": "2025-excavator-vtw-10-mini-excavator-A1-40139-212",
"title": "2025 Excavator VTW-10 Mini Excavator",
"images": [
{
"url": "https://media.tbauctions.com/image-media/d95e542f-e154-4eaf-8d15-bbb4dbb43b7e/file",
"order": 0,
"mediaId": "d95e542f-e154-4eaf-8d15-bbb4dbb43b7e"
}
],
"currency": "EUR",
"end_date": 1780596840,
"location": {
"id": "84603e78-7d6a-4b36-8f7c-9a298e0d6d8d",
"city": "Smilde",
"coordinates": "6.44869,52.94727",
"countryCode": "nl"
},
"sale_term": "OPEN_RESERVE_PRICE_NOT_ACHIEVED",
"bids_count": 15,
"display_id": "A1-40139-212",
"lot_number": 212,
"start_date": 1779451200,
"bidding_status": "BIDDING_OPEN",
"followers_count": 54,
"direct_sale_type": "NOT_SET",
"current_bid_amount_cents": 120000
}
],
"has_next": true,
"page_size": 3
}
}About the troostwijkauctions.com API
The Troostwijk Auctions API gives access to 2 endpoints covering industrial and commercial auction inventory across Europe. Use search_lots to query live listings by keyword with country, sort, and pagination controls, then call get_lot_details to retrieve a specific lot's full specification attributes, current bidding status, condition, images, and collection scheduling.
Endpoint Overview
The search_lots endpoint accepts a required query string and optional filters including a two-letter country code (e.g. nl, de, be), language, sort_by (currently endDate), sort_direction, page, and page_size. Each result in the results array includes the lot id, display_id, title, location, images, bids_count, current_bid_amount_cents, currency, bidding_status, and a slug used to fetch full details. The response also surfaces total, has_next, and page_size for reliable pagination.
Lot Detail Fields
get_lot_details takes a slug (returned from search results) and an optional language parameter. The response includes structured attributes — an array of specification objects each carrying a name, unit, and value — which represent the machine or asset specifications typical of heavy equipment, vehicles, and industrial goods listed on the platform. Additional fields cover condition, quantity, start_date (Unix timestamp), an auction object with id, name, and description, a location object with countryCode and city, and an ordered images array.
Coverage and Language Support
Both endpoints support 11 languages: English, Dutch, German, French, Italian, Spanish, Polish, Romanian, Swedish, Norwegian, and Finnish. Country filtering in search_lots is optional; omitting it returns results across all available regions. This makes the API suited for cross-border monitoring of industrial auction inventory throughout continental Europe.
- Monitor current bid prices for specific equipment categories (e.g. excavators, forklifts) across multiple European countries
- Build an equipment valuation tool using
current_bid_amount_cents,bids_count, andattributesfrom lot details - Aggregate auction closing dates by sorting
search_lotsresults byendDateascending to track upcoming lot expirations - Populate a multilingual asset database using
get_lot_detailswith thelanguageparameter for localized descriptions - Filter auction inventory by country code to surface lots available for viewing or collection in a specific region
- Track image assets and condition data for industrial equipment listings to support visual cataloguing workflows
- Build lot watchlists by periodically polling
search_lotsfor a keyword and detecting changes inbidding_status
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Troostwijk Auctions have an official developer API?+
What does `bidding_status` in the search results indicate?+
bidding_status field in each search_lots result reflects the current state of bidding on that lot — for example, whether bidding is open or has ended. It is paired with current_bid_amount_cents and bids_count to give a snapshot of auction activity at the time of the request.Can I retrieve bid history or individual bidder information for a lot?+
current_bid_amount_cents and bids_count from search_lots, and lot-level metadata from get_lot_details — but does not expose per-bid history or bidder identities. You can fork this API on Parse and revise it to add an endpoint targeting bid history if that data becomes accessible.How granular is the location data returned for lots?+
search_lots results include a location field, and get_lot_details returns a location object with countryCode and city. Street-level addresses and map coordinates are not currently returned. You can fork this API on Parse and revise it to surface more precise location fields if the source exposes them.Is there a way to filter search results by lot category or equipment type beyond keyword search?+
search_lots endpoint filters by query, country, and sort_by only — there is no dedicated category or asset-type filter parameter. Category-level filtering is not currently supported. You can fork this API on Parse and revise it to add a category filter endpoint if Troostwijk exposes category identifiers in their data.