BidSpotter
Industrial and commercial auctions in the US, Canada and the UK: catalogues, lots and live bids.
/bidspotter/v1/auctions1 creditAuction catalogues on BidSpotter, one clean row per auction: title, auctioneer, date and time (UTC and as shown), type (timed / live webcast / tender), status (upcoming, ending now, closed …), location and address, lot categories with counts, image and catalogue link. Filter by auction type, country, state, auctioneer, category or association; current or past auctions; 60 per page with the site's own total.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| site = us | optional | us · uk | Which BidSpotter marketplace. bidspotter.com and bidspotter.co.uk list different auctions. |
| status = current | optional | current · past | Current (incl. today's just-closed) or past auctions. |
| auction_type | optional | timed · live · tender · catalogue | Only timed online auctions, live webcasts, tenders or catalogue-only sales. |
| country | optional | — | Country of the auction, by name as the site lists it (United States, Canada, United Kingdom …; include_facets lists them). |
| state | optional | — | State / county, by name (include_facets lists them). |
| auctioneer | optional | — | Auctioneer by its exact name on the site (include_facets lists them). |
| category | optional | — | Lot category code (FRK = Forklifts, CAR = Cars, MCT = Machine Tools & Tools …; auctions[].categories[].code or include_facets). |
| master_category | optional | — | Top category code (IAC = Industrial & commercial, COV = Automotive & vehicles, MET = Metalworking, CAT = Food & beverage equipment …). |
| association | optional | — | Auctioneer association code (NAA, IAA, MDNA, AED, RICS). |
| sort | optional | date · auctioneer | Order: date (default) or auctioneer. |
| page = 1 | optional | 1–500 | Page, from 1. |
| exclude_closed = false | optional | — | Drop rows whose status is closed (today's finished sales stay on the current list). Paging and totals stay the site's own. |
| include_facets = false | optional | — | Also return the site's filter values with counts (auctioneers, countries, states, categories …) — use them as filter values. |
/bidspotter/v1/lots1 creditThe lots of one BidSpotter auction catalogue with the auction itself: every lot's number, title, description, image, opening price, current bid, bid count, next minimum bid, reserve met, closing time and location, plus the auction's dates, currency, buyer's premium, sales tax, venue address and auctioneer contact. Filter by keyword, category or brand; sort by lot number, closing time or bid.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | optional | — | A bidspotter.com or bidspotter.co.uk catalogue URL (any page of it), as in auctions[].url. |
| auction_ref | optional | — | The catalogue id (the part after catalogue-id- in its URL), as in auctions[].auction_ref. Use with site; the auctioneer is looked up. |
| site = us | optional | us · uk | Which BidSpotter marketplace. bidspotter.com and bidspotter.co.uk list different auctions. |
| page = 1 | optional | 1–500 | Page, from 1. |
| page_size = 60 | optional | 60 · 120 | Lots per page, as the site offers (60 or 120). |
| sort | optional | lot_number · newest · end_date · low_bid · high_bid | Order of lots (webcasts support lot_number and newest only). |
| query | optional | — | Only lots matching these words inside this catalogue. |
| category | optional | — | Only this lot category code (facets: categories). |
| brand | optional | — | Only this brand, as the site lists it (facets: brands). |
| include_bids = true | optional | — | Read the live bid state (current bid, bid count, next minimum bid, reserve met, closing time) from the site's bid service: one extra small request. false = only what the page itself carries (no bid counts). |
| include_facets = false | optional | — | Also return the site's filter values with counts (auctioneers, countries, states, categories …) — use them as filter values. |
/bidspotter/v1/lot1 creditOne BidSpotter lot in full: title, lot number, the whole description, every image, current bid, bid count, opening price, next minimum bid, reserve met, buy-it-now, start and closing time, hammer price when sold and published, lot location, buyer's premium, sales tax, payment methods, removal / pickup notes, watchers, previous and next lot, the auction and the auctioneer's contact.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | optional | — | A bidspotter.com / bidspotter.co.uk lot URL (lots[].url). |
| auction_ref | optional | — | The catalogue id (the part after catalogue-id- in its URL), as in auctions[].auction_ref. Use with site; the auctioneer is looked up. |
| lot_id | optional | — | The lot's UUID (lots[].lot_id); with auction_ref instead of url. |
| site = us | optional | us · uk | Which BidSpotter marketplace. bidspotter.com and bidspotter.co.uk list different auctions. |
| include_bids = true | optional | — | Read the live bid state (current bid, bid count, next minimum bid, reserve met, closing time) from the site's bid service: one extra small request. false = only what the page itself carries (no bid counts). |
/bidspotter/v1/search1 creditSearch lots across every BidSpotter auction by keyword (forklift, cnc lathe, john deere …), narrowed by country, state, auction type, auctioneer, category or brand. Each row is a lot with its auction and auctioneer, prices, current bid, bid count and closing time, with the site's own total. Matching is the site's (fuzzy: forklift also finds fork lift / lift truck).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Words to search lot titles and descriptions for. |
| site = us | optional | us · uk | Which BidSpotter marketplace. bidspotter.com and bidspotter.co.uk list different auctions. |
| country | optional | — | Lot country, by name (facets: countries). |
| state | optional | — | Lot state / county, by name (facets: states). |
| auction_type | optional | timed · live | Only timed or only webcast lots. |
| auctioneer | optional | — | Auctioneer by its exact name (facets: auctioneers). |
| category | optional | — | Lot category code (facets: categories). |
| master_category | optional | — | Top category code (facets: master_categories). |
| brand | optional | — | Brand, as the site lists it (facets: brands). |
| sort | optional | relevance · auction_date · auction_house · newest | Order: relevance (default), auction_date, auction_house, newest. |
| page = 1 | optional | 1–500 | Page, from 1. |
| include_bids = true | optional | — | Read the live bid state (current bid, bid count, next minimum bid, reserve met, closing time) from the site's bid service: one extra small request. false = only what the page itself carries (no bid counts). |
| include_facets = false | optional | — | Also return the site's filter values with counts (auctioneers, countries, states, categories …) — use them as filter values. |
/bidspotter/v1/bids1 creditLive bid state for up to 120 BidSpotter lots in one call (timed and webcast): current bid, bid count, opening price, next minimum bid, reserve met, closing time and closed. For watching lots you already know without re-reading the catalogue.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| lot_ids | required | — | Lot UUIDs (lots[].lot_id), up to 120. |
| site = us | optional | us · uk | Which BidSpotter marketplace. bidspotter.com and bidspotter.co.uk list different auctions. |
curl -X POST https://api.reefapi.com/bidspotter/v1/auctions \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"page":1}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.