Catawiki API: kavels, biedingen en veilinguitslagen als JSON

Alles wat een bieder op catawiki.com te zien krijgt — het hoogste bod, het aantal biedingen, wanneer de kavel sluit, de schatting van de expert, of de reserveprijs gehaald is — levert deze API als JSON, zonder in te loggen. Verkopers die kavels willen aanbieden of beheren, hebben er niets aan: er wordt niet meegeboden en niets online gezet, alleen gelezen wat openbaar op de site staat, vanuit de koper gezien en op het moment van de aanroep. Met `"language": "nl"` komen titels, specificaties en categorienamen in de Nederlandse vertaling van Catawiki zelf; bedragen zijn standaard in euro, en via `currency` ook in pond of dollar.

Werkend voorbeeld

Het bod is niet wat je betaalt. Op deze Kuifje-kavel stond het hoogste bod op € 30; daar komen de kosten voor kopersbescherming bij (9% + € 3 = € 5,70) en € 18 verzending naar Nederland, samen € 53,70 in `total_if_won_now`. Dat totaal rekent de API alleen uit voor kavels die nog open zijn, en alleen als je `shipping_country` meegeeft. Zonder land krijg je wel alle tarieven, maar geen totaal.

curl -X POST https://api.reefapi.com/catawiki/v1/product/detail \
  -H "x-api-key: JOUW_SLEUTEL" \
  -H "content-type: application/json" \
  -d '{"lot_id": 106704692, "shipping_country": "nl", "language": "nl"}'

{
  "ok": true,
  "data": {
    "item": {
      "lot_id": 106704692,
      "title": "Tintin Potiche Lotus Bleu musical - Trousselier - 1993",
      "subtitle": "Hergé - Zeer goed - Met de originele doos",
      "status": "open",
      "is_sold": false,
      "currency": "EUR",
      "current_bid": 30,
      "bid_count": 10,
      "next_minimum_bid": 35,
      "reserve_price_met": null,
      "experts_estimate": null,
      "buyer_protection_fee": { "percentage": 9, "fixed": 3, "currency": "EUR" },
      "buyer_protection_fee_amount": 5.7,
      "total_if_won_now": 53.7,
      "end_time": "2026-10-28T18:53:00Z",
      "auction_id": 1283068,
      "category": { "id": 1559, "url": "https://www.catawiki.com/nl/c/1559-herge-kuifje-stripfiguurbeeldjes-en-merchandise", "level": 2 },
      "attributes": { "condition": "Zeer goed", "material": "Hout", "year": 1993, ... },
      "shipping": {
        "destination": { "code": "nl", "name": "Nederland", "price": 18, "available": true, "currency": "EUR" },
        "rates": [
          { "country_code": "at", "country": "Oostenrijk", "price": 18, "currency": "EUR" },
          { "country_code": "be", "country": "België", "price": 15, "currency": "EUR" },
          { "country_code": "de", "country": "Duitsland", "price": 20, "currency": "EUR" },
          ...
        ],
        "delivery_days": { "from": 5, "to": 10 },
        "payment_methods": ["iDEAL | Wero", "MasterCard", "Visa", "Apple Pay", "Google Pay", "Bankoverboeking"]
      },
      ...
    },
    "auction": {
      "auction_id": 1283068,
      "title": "Hergé / Kuifje stripfiguurbeeldjes en merchandise-veiling",
      "status": "open_now",
      "close_time": "2026-10-28T18:00:00Z",
      "lot_count": 66,
      ...
    }
  },
  "meta": { "record_count": 1, "cache_hit": false, "mode": "live" }
}

Grenzen en eerlijke kanttekeningen

• Catawiki is geen partij bij deze API: we zijn geen partner van Catawiki en dit is niet hun officiële interface.
• Een zoekopdracht over gesloten of verkochte kavels bestaat niet; een filter op 'gesloten' negeert Catawiki. Uitslagen komen per veiling (auction/lots) of per kavel (product/detail).
• Hoe hoog de reserveprijs is, publiceert Catawiki niet. Je ziet alleen of er een is en of die gehaald is (`reserve_price_met`, null als er geen reserve is).
• Niet elke kavel heeft een schatting. Bij klassieke auto's ontbrak `experts_estimate` in 4 van de 4 gemeten kavels, en bij de twee Kuifje-kavels die we voor deze pagina opvroegen was het veld ook null.
• Titels zijn niet altijd helemaal Nederlands. Met `language: nl` bleef in de zoekopdracht 'kuifje' een deel van de titels Frans ('Tintin - Présentoir Tintin - 1 Promotionele display - 1991'). Naast de beschrijving van de verkoper staat een automatische vertaling in `auto_translated_description`.
• Tijden staan in UTC. De kavel hierboven sluit om 18:53Z, op 28 oktober is dat 19:53 uur in Nederland; in de zomertijd scheelt het twee uur.
• Oude kavels worden gearchiveerd (lot 90000000 gaf NOT_FOUND), en niet elk veilingnummer bestaat: 1278000 gaf NOT_FOUND, 1276500 een gesloten veiling. Gebruik het `auction_id` uit de rijen in plaats van zelf nummers op te hogen.
• Biedstanden worden bij elke aanroep opnieuw bij Catawiki opgevraagd; er zit geen bewaarde kopie tussen.