# Zoll-Auktion API scraper - the official German public auction house (Zoll-Auktion.de) of the federal government, the Länder and the municipalities: customs-seized and surplus public property. Search running auctions by keyword, category, price, postcode radius and delivery; full auction records with the absolute closing time, the current or final bid, bid count, next minimum bid, the public-authority seller, collection address and vehicle data; the masked bid history; every auction of one authority. EUR, German. No account, no browser.

> 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.
> ReefAPI engine `zoll-auktion` · 6 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/zoll-auktion/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/zoll-auktion/v1/search — 1 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.

**Parameters:**
- `query` (string, optional) — Keyword, in German as the listings are written (e.g. 'Fahrrad', 'Rolex', 'Ford'). Optional: leaving it out returns every running auction.
- `category_id` (array, 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` (enum, optional, default "ending_soon") — Order of the results. Only the orderings the site itself offers are accepted. [one of: ending_soon, ending_last, newest, oldest, price_asc, price_desc]
- `page` (integer, optional, default 1) — 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` (number, optional) — Only auctions whose current price is at least this many euros.
- `max_price` (number, optional) — Only auctions whose current price is at most this many euros.
- `postcode` (string, optional) — Five-digit German postcode to search around. Combine with radius_km.
- `radius_km` (enum, optional) — Search radius in kilometres around `postcode`. Only works together with postcode; the site offers exactly these distances. [one of: 20, 50, 100, 250, 500]
- `delivery` (array, optional) — Only auctions offering these ways of getting the goods. Several may be given; the site ORs them. [one of: pickup, germany, eu, europe]

**Returns:** query, auctions[]{auction_id, title, url, image, image_alt, currency (EUR), price (number), price_display (the site's own string - compare it with price), price_is (start_price|current_bid), current_bid (null until somebody bids), start_price (null once bidding started), bid_count, has_bids, postcode, city, delivery_note, pickup_only, time_left_display, time_left_seconds (minute-rounded, the site's own countdown), end_time (null in a row - only product/detail has the absolute time), rating (null), review_count (null)}, count, total_results, page, total_pages, has_more, page_out_of_range, filters{}

**Example request body:**
```json
{
  "sort": "ending_soon"
}
```

### POST https://api.reefapi.com/zoll-auktion/v1/product/detail — 1 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.

**Parameters:**
- `auction_id` (integer, required) — 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.

**Returns:** item{auction_id, title, url, charge, status (running|ended), currency, price, price_display, price_is (start_price|current_bid|final_price), current_bid, start_price, final_price, sold, bid_count, has_bids, minimum_bid, minimum_bid_display, end_time, end_time_display, start_time, start_time_display, time_left_display, time_left_seconds, notice, view_count, seller{seller_id, name, url, other_auctions}, location{postcode, city, street, address_extra, state}, contact{name, phone, email}, pickup, shipping, shipping_available, payment_methods[], vat_shown, storage_fee_note, auction_type, consumer_note, vat_note, warranty_note, category_path[]{category_id, name, url}, description, specifications[]{label, value}, vehicle{make, model, body_type, power, first_registration, mileage_km, fuel, next_inspection, transmission, air_conditioning, colour, paint, doors, emission_class}, images[], image, image_count, bid_history_url, rating (null), review_count (null), gtin (null), reserve_price (null - public-law auctions have none)}

**Example request body:**
```json
{
  "auction_id": 980596
}
```

### POST https://api.reefapi.com/zoll-auktion/v1/product/bids — 1 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).

**Parameters:**
- `auction_id` (integer, required) — 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.

**Returns:** auction_id, title, url, currency, bids[]{position, bidder, amount, amount_display, time, time_display, agent_activated_at, agent_activated_at_display, is_highest}, count, highest_bid

**Example request body:**
```json
{
  "auction_id": 980596
}
```

### POST https://api.reefapi.com/zoll-auktion/v1/seller/auctions — 1 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.

**Parameters:**
- `seller_id` (integer, required) — 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` (integer, optional, default 1) — Result page, 1-based; the seller page shows 10 auctions per page.

**Returns:** seller{seller_id, name, url, street, address_extra, postcode, city, homepage, description}, auctions[]{auction_id, title, url, image, image_alt, currency (EUR), price (number), price_display (the site's own string - compare it with price), price_is (start_price|current_bid), current_bid (null until somebody bids), start_price (null once bidding started), bid_count, has_bids, postcode, city, delivery_note, pickup_only, time_left_display, time_left_seconds (minute-rounded, the site's own countdown), end_time (null in a row - only product/detail has the absolute time), rating (null), review_count (null)}, count, total_results, page, total_pages, has_more, page_out_of_range

**Example request body:**
```json
{
  "seller_id": 124
}
```

### POST https://api.reefapi.com/zoll-auktion/v1/category/products — 1 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.

**Parameters:**
- `category_id` (array, 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` (string, optional) — Keyword, in German as the listings are written (e.g. 'Fahrrad', 'Rolex', 'Ford'). Optional: leaving it out returns every running auction.
- `sort` (enum, optional, default "ending_soon") — Order of the results. Only the orderings the site itself offers are accepted. [one of: ending_soon, ending_last, newest, oldest, price_asc, price_desc]
- `page` (integer, optional, default 1) — 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` (number, optional) — Only auctions whose current price is at least this many euros.
- `max_price` (number, optional) — Only auctions whose current price is at most this many euros.
- `postcode` (string, optional) — Five-digit German postcode to search around. Combine with radius_km.
- `radius_km` (enum, optional) — Search radius in kilometres around `postcode`. Only works together with postcode; the site offers exactly these distances. [one of: 20, 50, 100, 250, 500]
- `delivery` (array, optional) — Only auctions offering these ways of getting the goods. Several may be given; the site ORs them. [one of: pickup, germany, eu, europe]

**Returns:** category_id, auctions[]{auction_id, title, url, image, image_alt, currency (EUR), price (number), price_display (the site's own string - compare it with price), price_is (start_price|current_bid), current_bid (null until somebody bids), start_price (null once bidding started), bid_count, has_bids, postcode, city, delivery_note, pickup_only, time_left_display, time_left_seconds (minute-rounded, the site's own countdown), end_time (null in a row - only product/detail has the absolute time), rating (null), review_count (null)}, count, total_results, page, total_pages, has_more, page_out_of_range, filters{}

**Example request body:**
```json
{
  "category_id": "216"
}
```

### POST https://api.reefapi.com/zoll-auktion/v1/categories — 1 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.

**Parameters:** none

**Returns:** categories[]{category_id, name, parent_id, level, selectable, url}, count

## 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=zoll-auktion
- Human docs page: https://reefapi.com/docs/zoll-auktion
- Overview page: https://reefapi.com/zoll-auktion-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
