# Auctionet — Nordic & European auction aggregator

> Search Auctionet's whole catalogue — ~90 auction houses in Sweden, Denmark, Finland, Germany, Spain and the UK — either the live lots or the closed archive. Every filter is optional; with none you get the newest live lots. Each row carries its own currency: one page routinely mixes SEK, DKK, EUR and GBP, and nothing here is converted.
> ReefAPI engine `auctionet` · 4 endpoints · clean JSON, no scraping or browsers to manage.

## Measured
- Auctionet API, measured on live customer calls 17 Oct – 16 Nov 2026: 100% of calls succeeded, median response 1.4 s. Failures count only when the problem is ours (blocked, source error, parse error, timeout); not-found results and invalid parameters are not failures.
- OpenAPI 3.0 spec for this API: https://api.reefapi.com/openapi/auctionet.json

## How to call
- **Endpoint:** `POST https://api.reefapi.com/auctionet/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/auctionet/v1/search — 1 credit
Search Auctionet's whole catalogue — ~90 auction houses in Sweden, Denmark, Finland, Germany, Spain and the UK — either the live lots or the closed archive. Every filter is optional; with none you get the newest live lots. Each row carries its own currency: one page routinely mixes SEK, DKK, EUR and GBP, and nothing here is converted.

**Parameters:**
- `query` (string, optional) — Free-text search over lot title, description and catalogue number (e.g. 'rolex', 'orrefors vas', 'jugend lampa'). Leave it out to browse the whole catalogue newest-first.
- `status` (enum, optional, default "live") — Which side of the catalogue to search. 'live' = lots still open for bidding; 'ended' = the closed archive, which holds both sold and unsold lots (read `is_sold` on each row). [one of: live, ended]
- `country` (enum, optional) — Restrict to the auction houses of one country. Auctionet serves six. [one of: SE, DK, FI, DE, ES, GB]
- `house_id` (integer, optional) — Restrict to one auction house, by its Auctionet id. Call the `houses` action to get the ids together with the house names and their lot counts.
- `category_id` (integer, optional) — Restrict to one category, by its Auctionet id. Call the `categories` action for the full tree; a child id (e.g. 34 'Other clocks') narrows further than its parent (31 'Clocks & Watches').
- `sort` (enum, optional, default "relevance") — Row order. The estimate and bid orders are ranked by Auctionet across currencies, so the numbers you see are not monotonic in any single currency. 'sold_only_recent' additionally drops unsold lots. [one of: relevance, ending_soonest, ending_latest, estimate_low_first, estimate_high_first, bid_low_first, bid_high_first, fewest_bids, most_bids, sold_only_recent]
- `page` (integer, optional, default 1) — 1-based page. Auctionet serves at most 10,000 lots per query, so the last reachable page is 10000/max_results — narrow the query to go deeper.
- `max_results` (integer, optional, default 50) — Rows per page, 1-200 (Auctionet's own ceiling is 200).
- `locale` (enum, optional, default "en") — Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written. [one of: en, sv, da, fi, de, es, nb, fr, nl]

**Returns:** {query, status, total_available, page, page_count, currencies, results[]} — each result has item_id, url, title, description, condition, house, house_id, location, category_id, category, currency, estimate_low, estimate_high, starting_bid, current_bid, final_bid, bid_count, next_bid_amount, reserve_amount, reserve_met, is_sold, status, ends_at, published_at, images.

**Example request body:**
```json
{
  "query": "rolex",
  "max_results": 10
}
```

### POST https://api.reefapi.com/auctionet/v1/detail — 1 credit
One lot in full, live or from the archive, with its complete bid history (amount, bidder number and timestamp per bid). Takes the numeric lot id or any auctionet.com lot URL.

**Parameters:**
- `item` (string, required) — The numeric Auctionet lot id, or a full lot URL such as https://auctionet.com/en/5336678-...
- `locale` (enum, optional, default "en") — Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written. [one of: en, sv, da, fi, de, es, nb, fr, nl]

**Returns:** One lot object — the search row plus `bids` (newest first: amount, bidder, timestamp, is_auto) and `category_path`.

**Example request body:**
```json
{
  "item": "5336678"
}
```

### POST https://api.reefapi.com/auctionet/v1/categories — 1 credit
Auctionet's category tree — top-level categories with their children, each with the id the `category_id` filter takes. Names follow `locale`.

**Parameters:**
- `locale` (enum, optional, default "en") — Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written. [one of: en, sv, da, fi, de, es, nb, fr, nl]

**Returns:** {locale, count, categories[]} with {id, name, children[]} per node.

**Example request body:**
```json
{
  "locale": "en"
}
```

### POST https://api.reefapi.com/auctionet/v1/houses — 1 credit
Which auction houses, countries and categories hold lots matching a query, each with its lot count. This is the only published place an auction-house id is paired with its name, so it is how you learn the `house_id` values the search filter takes. Call it with no query for the whole catalogue.

**Parameters:**
- `query` (string, optional) — Free-text search over lot title, description and catalogue number (e.g. 'rolex', 'orrefors vas', 'jugend lampa'). Leave it out to browse the whole catalogue newest-first.
- `status` (enum, optional, default "live") — Which side of the catalogue to search. 'live' = lots still open for bidding; 'ended' = the closed archive, which holds both sold and unsold lots (read `is_sold` on each row). [one of: live, ended]
- `country` (enum, optional) — Restrict to the auction houses of one country. Auctionet serves six. [one of: SE, DK, FI, DE, ES, GB]
- `locale` (enum, optional, default "en") — Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written. [one of: en, sv, da, fi, de, es, nb, fr, nl]

**Returns:** {query, status, total_available, houses_cover_all, houses[], countries[], categories[]} — each entry {id, name, item_count}.

**Example request body:**
```json
{
  "query": "rolex",
  "status": "ended"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=auctionet
- Human docs page: https://reefapi.com/docs/auctionet
- Overview page: https://reefapi.com/auctionet-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
