Reef AI: ask for any data. Try it
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 →
Classifieds & Second-hand

Auctionet API & Scraper

Auctionet API returns live Auctionet data as clean JSON for auctionet The primary endpoint, search, returns {query, status, total_available, page, page_count, currencies, results[]} — each result has item_id, url, title, description, condition,….

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Success rate
100%
Median response
1.4 s
Fields per result
27
Endpoints
4
Measured on live customer calls, OpenAPI spec ↗
How we count

A call counts as failed only when the problem is on our side: the site blocked us, the source returned an error, we could not parse the page, or it timed out. Not-found results, invalid or missing parameters, used-up credit and rate limits are not failures of the API and are left out. Our own test traffic is excluded. The window is the last 30 days and moves once a week.

Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Auctionet scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, detail, categories, houses. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/auctionet/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "rolex",
    "max_results": 10
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "auctionet",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1974.2,
    "record_count": 10,
    "bytes": 53986,
    "cache_hit": false,
    "stop_reason": "limit_reached",
    "total_available": 17,
    "reachable_pages": 2,
    "currencies": {
      "EUR": 2,
      "SEK": 7,
      "GBP": 1
    },
    "sort_filters_unsold": false,
    "charged_credits": 1,
    "version": "1.0.0",
    "request_id": "e139ef481dd94618",
    "queue_ms": 1.2,
    "fetched_at": "2026-11-03T17:32:00.796Z"
  },
  "data": {
    "query": "rolex",
    "status": "live",
    "sort": "relevance",
    "filters": {
      "country": null,
      "house_id": null,
      "category_id": null
    },
    "total_available": 17,
    "page": 1,
    "page_count": 10,
    "currencies": {
      "EUR": 2,
      "SEK": 7,
      "GBP": 1
    },
    "amounts_note": "Every amount is in that row's own `currency`; nothing is converted.",
    "results": [
      {
        "item_id": 5290877,
        "url": "https://auctionet.com/en/5290877-rolex-gmt-master-ref-16700",
        "title": "Rolex GMT-Master ref. 16700.",
        "description": "40 mm diameter steel case. Steel Oyster bracelet with folding clasp. Black dial with date at three o'clock and sapphire crystal. Automatic movement with calibre 3175. Accompanied by original box and papers.",
        "condition": "In very good condition. Running at the time of cataloguing. No further warranty offered.",
        "house": "Balclis",
        "house_id": 223,
        "location": "Barcelona",
        "lot_placement": "Joyas Sala",
        "catalog_number": null,
        "category_id": 15,
        "category": "Wristwatches",
        "auction_id": 9825090,
        "event_id": null,
        "auction_format": "online",
        "status": "live",
        "outcome": "published",
        "is_sold": null,
        "currency": "EUR",
        "estimate_low": 15300,
        "estimate_high": null,
        "starting_bid": 30,
        "current_bid": 6700,
        "final_bid": null,
        "bid_count": 9,
        "next_bid_amount": 6900,
        "reserve_amount": null,
        "reserve_met": false,
        "ends_at": "2026-11-11T20:05:00Z",
        "published_at": "2026-11-02T10:42:56Z",
        "image_count": 10,
        "images": [
          "https://images.auctionet.com/thumbs/hd_item_5290877_0c8df740f313f8601435d142ae70e12d.jpg",
          "https://images.auctionet.com/thumbs/hd_item_5290877_785485c9fcdcc8e74faea085f914af44.jpg",
          "https://images.auctionet.com/thumbs/hd_item_5290877_d0626e023258626fcb78a5ee2fdab15b.jpg"
        ],
        "thumbnail": "https://images.auctionet.com/thumbs/w640_item_5290877_0c8df740f313f8601435d142ae70e12d.jpg"
      },
      {
        "item_id": 5402145,
        "url": "https://auctionet.com/en/5402145-rolex-wallet-red-leather",
        "title": "ROLEX, plånbok, rött skinn.",
        "description": "L. 11,5, B. 8,5 cm. Invändigt märkt Montres Rolex S.A Geneva, Switzerland code 60.02.03.",
        "condition": "Smärre rispor och ytsmuts.",
        "house": "Uppsala Auktionskammare",
        "house_id": 567,
        "location": "Uppsala",
        "lot_placement": "Monter",
        "catalog_number": null,
        "category_id": 49,
        "category": "Vintage & Designer Fashion",
        "auction_id": 9818460,
        "event_id": null,
        "auction_format": "online",
        "status": "live",
        "outcome": "published",
        "is_sold": null,
        "currency": "SEK",
        "estimate_low": 1000,
        "estimate_high": null,
        "starting_bid": 300,
        "current_bid": null,
        "final_bid": null,
        "bid_count": 0,
        "next_bid_amount": 300,
        "reserve_amount": null,
        "reserve_met": false,
        "ends_at": "2026-11-07T14:40:00Z",
        "published_at": "2026-10-30T07:44:55Z",
        "image_count": 3,
        "images": [
          "https://images.auctionet.com/thumbs/hd_item_5402145_88b6a33f87e3f1c457c23f911998c09c.jpg",
          "https://images.auctionet.com/thumbs/hd_item_5402145_a3380b8239e97f6661f0acde008add49.jpg",
          "https://images.auctionet.com/thumbs/hd_item_5402145_fa91a5a1d6e21738c0985b1bfdaa5d77.jpg"
        ],
        "thumbnail": "https://images.auctionet.com/thumbs/w640_item_5402145_88b6a33f87e3f1c457c23f911998c09c.jpg"
      },
      {
        "item_id": 5486525,
        "url": "https://auctionet.com/en/5486525-rolex-date-wristwatch",
        "title": "Rolex Date Armbanduhr.",
        "description": "Armbanduhr von Rolex, Modell ''Date'' Ref. 15238. Gehäuse gefertigt aus 750er Gold, Zifferblatt mit Minuten- Stunden und Sekundenzeiger, Automatik-Uhrwerk. Datum bei '3' Uhr. Maße ca. Gehäusedurchmesser 34 mm. Zum Zeitpunkt der Begutachtung lief die Uhr, Stockholms Auktionsverk garantiert nicht für die Funktionalität.",
        "condition": "Tragespuren, Gehäuse mit einigen tiefen Kratzern, Zifferblatt repariert.",
        "house": "Stockholms Auktionsverk Hamburg",
        "house_id": 244,
        "location": "Hamburg",
        "lot_placement": "Auf Anfrage ",
        "catalog_number": null,
        "category_id": 15,
        "category": "Wristwatches",
        "auction_id": 9750396,
        "event_id": null,
        "auction_format": "online",
        "status": "live",
        "outcome": "published",
        "is_sold": null,
        "currency": "EUR",
        "estimate_low": 7000,
        "estimate_high": null,
        "starting_bid": 25,
        "current_bid": 4005,
        "final_bid": null,
        "bid_count": 18,
        "next_bid_amount": 4205,
        "reserve_amount": null,
        "reserve_met": false,
        "ends_at": "2026-11-04T19:18:00Z",
        "published_at": "2026-10-29T10:41:34Z",
        "image_count": 4,
        "images": [
          "https://images.auctionet.com/thumbs/hd_item_5486525_cebb4d155148dc3eed3f56c00b22603d.jpg",
          "https://images.auctionet.com/thumbs/hd_item_5486525_84c353ee93fed65d8bc603bb83a21009.jpg",
          "https://images.auctionet.com/thumbs/hd_item_5486525_83e1e2bec4238e1061deaaafd5ed6ea5.jpg"
        ],
        "thumbnail": "https://images.auctionet.com/thumbs/w640_item_5486525_cebb4d155148dc3eed3f56c00b22603d.jpg"
      }
    ]
  }
}
Actions

What the Auctionet API does

ActionDescriptionConcrete use caseKey params
searchSearch 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.Price-intelligence teams call search to search Auctionet's whole catalogue.query, status, country, house_id, category_id, ...
detailOne 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.Classifieds aggregators call detail to get one lot in full, live or from the archive, with its complete bid history (amount, bidder numb….item, locale
categoriesAuctionet's category tree — top-level categories with their children, each with the id the `category_id` filter takes. Names follow `locale`.Resale and arbitrage tools call categories to get auctionet's category tree.locale
housesWhich 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.Lead-generation teams call houses to get which auction houses, countries and categories hold lots matching a query, each with its lot….query, status, country, locale
Code samples

Call search from your stack

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}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.auctionet.search with {"query":"rolex","max_results":10}.
Use cases

Who uses this API and why

  • Price-intelligence teams use Auctionet to search Auctionet's whole catalogue.
  • Classifieds aggregators use Auctionet to get one lot in full, live or from the archive, with its complete bid history (amount, bidder numb….
  • Resale and arbitrage tools use Auctionet to get auctionet's category tree.
  • Lead-generation teams use Auctionet to get which auction houses, countries and categories hold lots matching a query, each with its lot….
FAQ

Questions developers ask before integrating

What is the Auctionet API?

Auctionet API is a ReefAPI endpoint group for auctionet It returns live JSON through POST requests under /auctionet/v1.

Is the Auctionet API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Auctionet calls use the same shared credit balance as every other ReefAPI engine.

Do I need an Auctionet login or account?

No login to Auctionet is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Auctionet data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Auctionet API use?

Auctionet actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Auctionet from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call auctionet actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Auctionet API an Auctionet scraper?

It is the managed alternative to a DIY Auctionet scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same auctionet back as clean JSON.

Why does my Auctionet scraper keep getting blocked?

Most Auctionet scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / auctionet

Auctionet

Auctionet

base /auctionet/v14 endpoints
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.

ParameterAllowed / rangeDescription
itemrequired—The numeric Auctionet lot id, or a full lot URL such as https://auctionet.com/en/5336678-...
locale = enoptionalen · sv · da · fi · de · es · nb · fr · nlLanguage 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`.

ParameterAllowed / rangeDescription
locale = enoptionalen · sv · da · fi · de · es · nb · fr · nlLanguage 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.

ParameterAllowed / rangeDescription
queryoptional—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 = liveoptionallive · endedWhich 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).
countryoptionalSE · DK · FI · DE · ES · GBRestrict to the auction houses of one country. Auctionet serves six.
locale = enoptionalen · sv · da · fi · de · es · nb · fr · nlLanguage for the category names Auctionet translates. Lot titles and descriptions are written by the auction house and are returned as written.
Try in playground →
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.