Troostwijk Auctions APItroostwijkauctions.com ↗
Search Troostwijk auction lots, retrieve live bidding data, specs, images, and location info via 3 structured endpoints. Filter by country, language, and sort order.
What is the Troostwijk Auctions API?
The Troostwijk Auctions API gives developers structured access to industrial and commercial auction data across 3 endpoints. Use search_lots to run full-text queries across active lots with filters for country, language, and sort order, then call get_lot_details to pull complete metadata including technical attributes, images, condition, and viewing/collection schedules. A third endpoint handles batched lookups of up to 20 lots by display ID in a single request.
curl -X GET 'https://api.parse.bot/scraper/fbcfbbed-b376-4eb3-a263-540b20e4dc86/search_lots?page=1&query=excavator&country=nl&sort_by=endDate&language=en&page_size=5&sort_direction=asc' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search across Troostwijk auction lots. query matches lot titles; results include bidding status, current bid, location, and images. Supports country filtering and sorting by end date. Paginates via page number. Each result exposes a slug for fetching full details via get_lot_details.
| 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. Used with sort_by. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"total": "integer - total number of matching lots",
"results": "array of LotSummary objects",
"has_next": "boolean - whether more pages exist",
"page_size": "integer - results per page"
},
"sample": {
"data": {
"page": 1,
"total": 836,
"results": [
{
"id": "718df39e-853b-4d47-a913-fadcb75add35",
"slug": "2022-excavator-rdt-11-crawler-excavator-A1-45904-18",
"title": "2022 Excavator RDT-11 Crawler Excavator",
"images": [
{
"url": "https://media.tbauctions.com/image-media/8ea37d60-4508-49eb-99ce-b69df1d24f05/file",
"order": 0
}
],
"currency": "EUR",
"end_date": 1782237060,
"location": {
"city": "Scharnegoutum",
"countryCode": "nl"
},
"sale_term": "OPEN_RESERVE_PRICE_NOT_ACHIEVED",
"bids_count": 21,
"display_id": "A1-45904-18",
"lot_number": 18,
"start_date": 1780668000,
"bidding_status": "BIDDING_OPEN",
"followers_count": 43,
"direct_sale_type": "NOT_SET",
"current_bid_amount_cents": 135000
}
],
"has_next": true,
"page_size": 5
},
"status": "success"
}
}About the Troostwijk Auctions API
Search and Filter Auction Lots
The search_lots endpoint accepts a required query string and returns paginated LotSummary objects. Each result includes the current bid, bidding status, location, images, and a slug field used to fetch full details. You can narrow results with the country parameter (two-letter codes like nl, de, fr), choose from 11 language values, and sort by endDate ascending or descending using sort_by and sort_direction. The response includes total, has_next, and page_size fields to handle pagination.
Full Lot Details
get_lot_details takes a slug from search results and returns a single lot object with attributes (an array of specification objects each carrying name, unit, and value), a full images array with ordering, auction metadata (auction ID, display ID, name, description), location with country code and city, quantity, condition, and start_date as a Unix timestamp. This endpoint is the right call when you need complete technical specifications for heavy equipment, vehicles, or industrial assets.
Batched Live Bidding Data
get_lots_by_display_ids accepts a comma-separated list of Troostwijk display IDs (for example A1-47383-311,A1-44177-240) with a maximum of 20 per request. It returns combined live bidding fields — current bid amount, bid count, bidding status, sale terms, and end date — merged with the same full detail fields available from get_lot_details. Lots not found are returned as objects containing only display_id and an error field, so batch responses are always the same length as the input list.
The Troostwijk Auctions API is a managed, monitored endpoint for troostwijkauctions.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when troostwijkauctions.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official troostwijkauctions.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor current bid amounts and end dates across multiple lots to automate bidding alerts.
- Aggregate technical attribute specs from heavy machinery lots for equipment comparison tools.
- Filter lots by country code and export location data for logistics or transport cost estimation.
- Build category-specific auction feeds (e.g. forklifts, excavators) using keyword search and pagination.
- Cross-reference display IDs from external spreadsheets against live auction status in batch.
- Track condition and quantity fields across lots to identify bulk-purchase opportunities.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Troostwijk Auctions have an official public developer API?+
What does get_lots_by_display_ids return that search_lots does not?+
Is historical auction data or past sale prices covered?+
What is the pagination behavior in search_lots?+
page integer parameter. The response includes total (total matching lots), page_size (results per page, also settable as an input), and has_next (boolean indicating whether additional pages exist). Iterate using page until has_next is false.Does the API expose seller information or company details for auction organizers?+
auction object in lot responses includes auction ID, display ID, name, and description, but no seller contact details, company registration data, or organizer profiles are returned. You can fork this API on Parse and revise it to surface additional auction-level fields if they become accessible.