Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Auctionet API page →

docs / auctionet

Auctionet

base /auctionet/v14 endpoints

post/auctionet/v1/search1 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.

Parameter		Allowed / range	Description
query	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 = live	optional	live · ended	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).
country	optional	SE · DK · FI · DE · ES · GB	Restrict to the auction houses of one country. Auctionet serves six.
house_id	optional	1–	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	optional	1–	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 = relevance	optional	relevance · ending_soonest · ending_latest · estimate_low_first · estimate_high_first · bid_low_first · bid_high_first · fewest_bids · most_bids · sold_only_recent	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.
page = 1	optional	1–1000	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 = 50	optional	1–200	Rows per page, 1-200 (Auctionet's own ceiling is 200).
locale = en	optional	en · sv · da · fi · de · es · nb · fr · nl	Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written.

Try in playground →

post/auctionet/v1/detail1 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.

Parameter		Allowed / range	Description
item	required	—	The numeric Auctionet lot id, or a full lot URL such as https://auctionet.com/en/5336678-...
locale = en	optional	en · sv · da · fi · de · es · nb · fr · nl	Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written.

Try in playground →

post/auctionet/v1/categories1 credit

Auctionet's category tree — top-level categories with their children, each with the id the `category_id` filter takes. Names follow `locale`.

Parameter		Allowed / range	Description
locale = en	optional	en · sv · da · fi · de · es · nb · fr · nl	Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written.

Try in playground →

post/auctionet/v1/houses1 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.

Parameter		Allowed / range	Description
query	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 = live	optional	live · ended	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).
country	optional	SE · DK · FI · DE · ES · GB	Restrict to the auction houses of one country. Auctionet serves six.
locale = en	optional	en · sv · da · fi · de · es · nb · fr · nl	Language for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/auctionet/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"rolex","max_results":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Built for volume

5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?

We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support

2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance

Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.