Klaravik API: pågående auktioner och bud i JSON
Klaravik publicerar inget API för utvecklare. API:et på den här sidan läser de svenska auktionerna så som de visas publikt på klaravik.se — titel, ort, aktuellt bud, antal bud och sluttid — och returnerar dem som JSON. Det är inte ett verktyg för att sälja via Klaravik eller för att lägga bud. Det är köparsidan: vad som ligger ute just nu och var buden står.
Endpoints
| endpoint | Vad som kommer tillbaka | Obligatoriska |
|---|---|---|
| search | Fritextsökning bland Klaraviks svenska auktioner, till exempel 'traktor' eller 'grävlastare'. Varje objekt kommer med aktuellt bud i SEK, antal bud, start- och sluttid och ort. Källan visar 60 objekt per sida, och sidorna 1–2 går att hämta. | query |
| listing_detail | Hela objektet från sökträffens `listing_id` eller dess Klaravik-adress: beskrivningen som Klaravik publicerar, aktuellt bud, nästa budnivå och budsteg, köparavgift, momssats, om reservationspriset är uppnått samt auktionens status och sluttid. | listing_id |
Varje anrop debiteras i krediter. Misslyckade och blockerade anrop är gratis.
Fungerande exempel
Det aktuella budet är inte vad köparen betalar. På Fendt-traktorn nedan står budet på 1 350 000 kr, men det är exklusive moms (`price_vat_basis: "excluding_vat"`), köparavgiften på 32 000 kr ingår inte (`buyer_fee_included: false`) och reservationspriset är ännu inte uppnått. Någon totalsumma räknar vi inte fram, men alla delar finns i svaret.
curl -X POST https://api.reefapi.com/klaravik/v1/listing_detail \
-H "x-api-key: DIN_NYCKEL" \
-H "content-type: application/json" \
-d '{"listing_id": "3313581-traktor-fendt-818-vario-med-frontlastare"}'{
"ok": true,
"data": {
"listing_id": "3313581-traktor-fendt-818-vario-med-frontlastare",
"auction_id": "3313581",
"title": "Traktor Fendt 828 Vario med frontlastare",
"price": 1350000,
"current_bid": 1350000,
"price_type": "current_bid",
"currency": "SEK",
"bid_count": 15,
"next_bid": 1352000,
"bid_step": 2000,
"buyer_fee": 32000,
"vat_rate": 25,
"vat_applicable": true,
"price_vat_basis": "excluding_vat",
"buyer_fee_included": false,
"reserve_status": "NOTREACHED",
"reserve_reached": false,
"auction_status": "online",
"auction_end": "2026-10-27T09:14:00+01:00",
"brand": "Fendt",
"model": "828 Vario",
"auctioneer": "Klaravik",
"seller": null
},
"meta": { "record_count": 1, "cache_hit": false, "mode": "live" }
}Bygga en egen Klaravik-scraper?
När vi byggde motorn visade sig Klaravik vara krångligare än det ser ut, av två skäl. Det första är objektens id: vissa objekt nås med bara siffrorna, andra kräver hela den beskrivande delen efter siffrorna. Ett skript som kortar ner adressen till numret tappar en del av objekten utan att märka det.
Det andra är att källan under testerna periodvis nekade anrop med HTTP 403. Motorn gör därför ett nytt försök inom anropets tidsgräns, och om nekandet består kommer det tillbaka som ett fel, inte som en tom träfflista.
Bud, nästa bud, köparavgift och moms kommer här som separata fält, och ett objekt utan bud får `price: null` i stället för noll. För en enstaka genomgång av ett sökord räcker ett eget skript; den som vill följa sluttider och budnivåer varje dag betalar för underhållet, inte för koden.
Gränser och ärliga noteringar
- Det här är inte Klaraviks officiella API och vi har inget samarbete med Klaravik.
- Bara de svenska auktionerna på klaravik.se ingår.
- Sökningen tar enbart fritext, utan kategorier, filter eller sortering. Källan ger 60 objekt per sida och bara sidorna 1–2 kan hämtas, så en bred sökning når högst 120 objekt: i vårt test gav 'traktor' 156 träffar, varav 120 var nåbara.
- Priset är alltid det aktuella budet, aldrig ett slutpris. Avslutade auktioner, budhistorik och säljarens identitet ingår inte.
- Det går inte att logga in, lägga bud eller bevaka objekt via API:et.