Zoll-Auktion API scraper - the official German public auction house

base /zoll-auktion/v16 endpoints

post/zoll-auktion/v1/search1 credit

Search the running auctions of Zoll-Auktion.de: auction id, title, image, the price the site shows (the start price until somebody bids, the current highest bid afterwards), the number of bids, the countdown, the collection postcode and town and whether the goods can only be collected. Filter by keyword, category, minimum and maximum price, postcode radius and delivery option; sort by closing time, start time or price. Every filter was measured to change the result total. Leaving every parameter out returns the whole catalogue of running auctions.

Parameter		Allowed / range	Description
query	optional	—	Keyword, in German as the listings are written (e.g. 'Fahrrad', 'Rolex', 'Ford'). Optional: leaving it out returns every running auction.
category_id	optional	—	Only auctions in these Zoll-Auktion categories (numbers such as 216 Gebrauchtwagen, 243 Uhren). The `categories` action lists them. Several may be given; the site ORs them.
sort = ending_soon	optional	ending_soon · ending_last · newest · oldest · price_asc · price_desc	Order of the results. Only the orderings the site itself offers are accepted.
page = 1	optional	1–10000	Result page, 1-based. The site serves a fixed 10 auctions per page. A page past the last one returns an empty list with page_out_of_range: true (the site itself would silently re-serve page 1).
min_price	optional	0–	Only auctions whose current price is at least this many euros.
max_price	optional	0–	Only auctions whose current price is at most this many euros.
postcode	optional	—	Five-digit German postcode to search around. Combine with radius_km.
radius_km	optional	20 · 50 · 100 · 250 · 500	Search radius in kilometres around `postcode`. Only works together with postcode; the site offers exactly these distances.
delivery	optional	pickup · germany · eu · europe	Only auctions offering these ways of getting the goods. Several may be given; the site ORs them.

Try in playground →

post/zoll-auktion/v1/product/detail1 credit

One Zoll-Auktion auction in full, running or already closed: title, description, every image, the absolute start and closing time, the current or final bid with the bid count and the next minimum bid, whether it sold, the number of views, the public-authority seller with its id, the collection address, federal state and case officer, collection/shipping/payment terms, VAT and warranty notes, the category path, and - for vehicles - make, model, first registration, mileage, fuel, transmission, power, colour and emission class.

Parameter		Allowed / range	Description
auction_id	required	1–	Zoll-Auktion auction id - the number at the end of a product URL (/auktion/produkt/<slug>/980596 -> 980596). A full auction URL works. Every search row returns it.

Try in playground →

post/zoll-auktion/v1/product/bids1 credit

The full bid history of one Zoll-Auktion auction, highest first: the amount, when it was placed, when the bidding agent that produced it was set up, and the bidder's masked handle (the site never publishes bidder identities).

Parameter		Allowed / range	Description
auction_id	required	1–	Zoll-Auktion auction id - the number at the end of a product URL (/auktion/produkt/<slug>/980596 -> 980596). A full auction URL works. Every search row returns it.

Try in playground →

post/zoll-auktion/v1/seller/auctions1 credit

One Zoll-Auktion seller - a customs office, police authority, city or municipality - with its address, website and description, plus its running auctions in the same shape as a search row.

Parameter		Allowed / range	Description
seller_id	required	1–	Zoll-Auktion seller (Anbieter) id - the number at the end of a seller URL (/auktion/anbieter/<slug>/124 -> 124). product/detail returns it for every auction.
page = 1	optional	1–10000	Result page, 1-based; the seller page shows 10 auctions per page.

Try in playground →

post/zoll-auktion/v1/category/products1 credit

Browse the running auctions of one Zoll-Auktion category with the same row fields as search and the same price, postcode-radius and delivery filters and sorts.

Parameter		Allowed / range	Description
category_id	optional	—	Only auctions in these Zoll-Auktion categories (numbers such as 216 Gebrauchtwagen, 243 Uhren). The `categories` action lists them. Several may be given; the site ORs them.
query	optional	—	Keyword, in German as the listings are written (e.g. 'Fahrrad', 'Rolex', 'Ford'). Optional: leaving it out returns every running auction.
sort = ending_soon	optional	ending_soon · ending_last · newest · oldest · price_asc · price_desc	Order of the results. Only the orderings the site itself offers are accepted.
page = 1	optional	1–10000	Result page, 1-based. The site serves a fixed 10 auctions per page. A page past the last one returns an empty list with page_out_of_range: true (the site itself would silently re-serve page 1).
min_price	optional	0–	Only auctions whose current price is at least this many euros.
max_price	optional	0–	Only auctions whose current price is at most this many euros.
postcode	optional	—	Five-digit German postcode to search around. Combine with radius_km.
radius_km	optional	20 · 50 · 100 · 250 · 500	Search radius in kilometres around `postcode`. Only works together with postcode; the site offers exactly these distances.
delivery	optional	pickup · germany · eu · europe	Only auctions offering these ways of getting the goods. Several may be given; the site ORs them.

Try in playground →

post/zoll-auktion/v1/categories1 credit

Zoll-Auktion's whole category tree as the site publishes it in its own search sidebar: id, name, parent and whether the category can be filtered on directly.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/zoll-auktion/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"sort":"ending_soon"}'

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.