Troostwijk Auctions APItroostwijkauctions.com ↗
Search auction lots and retrieve full lot details from Troostwijk Auctions including bids, specs, images, and location via a simple REST API.
What is the Troostwijk Auctions 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace troostwijkauctions-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.troostwijk_auctions_api import Troostwijk, SortDirection, LotSummary, Lot
client = Troostwijk()
# Search for excavators in Netherlands sorted by end date ascending
for lot in client.lotsummaries.search(query="excavator", country="nl", sort_direction=SortDirection.ASC, sort_by="endDate", limit=5):
print(lot.title, lot.display_id, lot.bids_count, lot.currency)
print(lot.location.country_code, lot.location.city)
# Drill into full details for this lot
detail = lot.details()
print(detail.title, detail.condition, detail.quantity, detail.followers_count)
for attr in detail.attributes:
print(attr.name, attr.value, attr.unit)
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
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.
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 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 | 100 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.