# Troostwijk Auctions — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse auction lots on Troostwijk Auctions to find detailed information about items including specifications, current bidding status, images, and physical locations. Quickly access comprehensive lot details to help you make informed bidding decisions or discover items of interest.

**Category:** Marketplaces | **Website:** [www.troostwijkauctions.com/](https://www.troostwijkauctions.com/) | **Docs:** [parse.bot/marketplace/fd76ba0a-3c80-4e41-9051-1e55b37706f1/troostwijkauctions-com-api](https://parse.bot/marketplace/fd76ba0a-3c80-4e41-9051-1e55b37706f1/troostwijkauctions-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-troostwijkauctions-com-api-fd76ba0a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_lot_details

Retrieve full details for a specific auction lot including specifications (attributes), description, images, auction information, viewing days, and collection days. The slug is available from search_lots results. Returns a single Lot with all available metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `language` | string | No | Language for lot details. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |
| `slug` | string | Yes | Lot URL slug from search_lots results[*].slug (e.g. '2025-excavator-vtw-10-mini-excavator-A1-40139-212'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-troostwijkauctions-com-api-fd76ba0a/get_lot_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"language":"<string>","slug":"<string>"}'
```

### get_lots_by_display_ids

Fetch combined live bidding data and detailed metadata for up to 20 lots by their display IDs in a single batched request. Returns current bid amounts, bid counts, bidding status, sale terms, end dates, plus full lot details including attributes, images, location, auction info, viewing and collection days. Lots not found are returned with an error marker. Accepts a comma-separated list of display IDs. Uses a single upstream GraphQL call regardless of batch size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `display_ids` | string | Yes | Comma-separated Troostwijk display IDs (e.g. 'A1-47383-311,A1-44177-240'). Maximum 20 per request. |
| `language` | string | No | Language for lot details. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-troostwijkauctions-com-api-fd76ba0a/get_lots_by_display_ids \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"display_ids":"<string>","language":"<string>"}'
```

### search_lots

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Two-letter country code to filter results (e.g. 'nl', 'be', 'de', 'fr', 'at'). Omitting returns results from all countries. |
| `language` | string | No | Language for search results. Accepted values: 'en', 'nl', 'de', 'fr', 'it', 'es', 'pl', 'ro', 'sv', 'no', 'fi'. |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | Yes | Search term to find lots (e.g. 'excavator', 'tractor', 'forklift'). |
| `sort_by` | string | No | Field to sort results by. Accepted value: 'endDate'. Omitting sorts by relevance. |
| `sort_direction` | string | No | Sort direction. Used with sort_by. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-troostwijkauctions-com-api-fd76ba0a/search_lots \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","language":"<string>","page":"<integer>","page_size":"<integer>","query":"<string>","sort_by":"<string>","sort_direction":"<string>"}'
```