# Auctiontime — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 equipment and truck auction listings from AuctionTime.com, view detailed information about specific auctions, filter by category and auctioneer, and track auction results by date. Access comprehensive auction data including listings, categories, and auctioneer information all in one place.

**Category:** Marketplaces | **Website:** [auctiontime.com/](https://auctiontime.com/) | **Docs:** [parse.bot/marketplace/608ff72c-1be8-456e-afd4-cb9e07b4976b/auctiontime-com-api](https://parse.bot/marketplace/608ff72c-1be8-456e-afd4-cb9e07b4976b/auctiontime-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all pages

Fetch listings across multiple pages (up to 7) for a category in a single request. Returns all collected listings with total_pages and pages_fetched counts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID. |
| `slug` | string | Yes | URL slug for the category. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-all-pages \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","slug":"<string>"}'
```

### Get auction by date

Fetch all upcoming auction listings for a specific date. Returns paginated results of auctions ending on the given date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Auction date in YYYY-MM-DD format. |
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-auction-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","page":"<integer>"}'
```

### Get auction results

Fetch sold auction results for a category. Returns completed/sold listing data including sold prices when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID. |
| `page` | integer | No | Page number. |
| `slug` | string | Yes | URL slug for the category. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-auction-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","slug":"<string>"}'
```

### Get auctioneer listings

Fetch active listings for a specific auctioneer by their URL slug. Use get_auctioneers to discover valid slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `auctioneer_slug` | string | Yes | Auctioneer URL slug (e.g., 'auctionblock', 'dagger-machinery'). |
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-auctioneer-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"auctioneer_slug":"<string>","page":"<integer>"}'
```

### Get auctioneers

Fetch a paginated list of auctioneers with contact info, location, and items sold count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-auctioneers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get categories

Fetch top-level auction categories with their IDs and URL slugs. These category IDs and slugs are used as inputs to get_listings, get_all_pages, and get_auction_results.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get listing detail

Fetch full detail for a single auction listing by its ID. Returns title, description, category, specs, current bid, sale end time, location, images, and other metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | Numeric listing ID (e.g. '255572897'). |
| `slug` | string | No | URL slug for the listing. Defaults to 'item' if unknown. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>","slug":"<string>"}'
```

### Get listings

Fetch paginated auction listings for a category. Returns up to 28 listings per page with title, location, lot number, specs, and image. Use get_categories to discover valid slug/category_id pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID (e.g., '1100' for tractors, '27' for trucks). |
| `page` | integer | No | Page number. |
| `slug` | string | Yes | URL slug for the category (e.g., 'tractors', 'trucks', 'trailers'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/get-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","slug":"<string>"}'
```

### Search listings

Search auction listings by keyword. Returns paginated results matching the query across all categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |
| `query` | string | Yes | Search keyword (e.g., 'John Deere', 'excavator'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/auctiontime/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.