# 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`.