SPB Git forge

spb/rareindex

Public
54commits 1branches 0releases
7.1 MBsize
maindefault branch
10 days agolast push
TypeScript 61.9% HTML 37.2% SQL 0.7%
1.5 KB

# auctionet — Auctionet (Nordic/European online auction platform)

Public, unauthenticated JSON endpoint https://auctionet.com/api/v2/items.json (is=ended, per_page, page, category_id, country_code), plus /api/v2/categories.json for the taxonomy tree. ~100 houses (Stockholms Auktionsverk, Crafoord, Uppsala Auktionskammare, Bruun Rasmussen online, Helsingborgs…), 3.9 M closed lots since 2011, native SEK / EUR / DKK / GBP.

  • Records: sale for state=sold (price = winning bid = hammer; buyerPremiumIncluded=false, each house adds its own buyer's fee — metadata.price_basis), auction_lot (status ended) for unsold.
  • Incremental: pages through the most recently ended lots until the previous checkpoint (sinceEndsAt) is met; incrementalMaxPages caps a run. Backfill: category × country slices (the API caps every query at 10 000 items → apiItemCap / perPage pages per slice), cursor {sliceIndex, page, itemsProcessed}, progress() per page, {done:true} at the end.
  • Taxonomy: CATEGORY_MAP (Auctionet id → slug + department hint) refined by _auction-lib title rules and multilingual cues (sv/de/da/fi/es). Licence weapons, firearms, vehicle parts, boats, mopeds, bicycles, garden, tools and consumer electronics are skipped.
  • Identifiers: auctionet_item_id (deterministic, unique per lot).
  • Tests: pnpm vitest run connectors/api/auctionet · fixtures: pnpm tsx connectors/api/auctionet/_capture.ts --save.