Equipment Facts

Heavy equipment auctions in the US and Canada: auctions, lots, specs and live bids.

base /equipmentfacts/v15 endpoints

post/equipmentfacts/v1/auctions1 credit

Every upcoming (or past) auction on Equipment Facts, one clean row per auction: title, auctioneer (name, phone, website, logo), date and start time (UTC and as shown), type (online timed sale or on-site / webcast auction) and bidding format, status, location and address, description, equipment types, lot count (online sales) and the catalogue and bidding links. Filter by type, state, date, keyword or auctioneer; 25 per page with the site's own total.

Parameter		Allowed / range	Description
status = upcoming	optional	upcoming · past	Upcoming auctions (default) or past auctions (auction results).
auction_type	optional	online · onsite	online = timed online sales (AuctionTime); onsite = live on-site / webcast auctions.
state	optional	—	US state or Canadian province, by name or 2-letter code (TX).
date	optional	—	Only auctions on this date (YYYY-MM-DD).
query	optional	—	Only auctions matching these words (title, description, auctioneer).
auctioneer_id	optional	—	Only this auctioneer's auctions (auctions[].auctioneer.account_id).
page = 1	optional	1–2000	Page, from 1.

Try in playground →

post/equipmentfacts/v1/lots1 credit

The lots (equipment items) of one Equipment Facts auction: lot number, title, year, make, model, category, serial / VIN, hours, mileage, specs, description, photos, location, lot URL and the live bid state (current bid, next bid, increment, bid count and closing time on online sales). Filter by keyword, category or lot number; sort by lot number, year, make or model. 28 per page.

Parameter		Allowed / range	Description
auction_id	optional	—	The auction's id (auctions[].auction_id).
url	optional	—	An auction catalogue URL (auctions[].catalogue_url) instead of auction_id.
page = 1	optional	1–2000	Page, from 1.
sort	optional	default · lot_number · year_asc · year_desc · manufacturer · model · recently_added · recently_updated	Order of lots.
query	optional	—	Only lots matching these words.
category	optional	—	Only this category id (filters facet=category).
lot_number	optional	—	Only this lot number.
include_bids = true	optional	—	Read the live bid state (current bid, next bid, increment, bid count on online sales, closing time) from the site's bid service: one extra small request. false = only what the lot list carries.

Try in playground →

post/equipmentfacts/v1/lot1 credit

One lot in full: title, lot number, year, make, model, category, condition, serial / VIN, hours, mileage, every spec, the whole description, every photo (full size), item location, the live bid state, closing time, buyer's premium, the auction (date, location, catalogue) and the auctioneer, previous and next lot. Online-sale lots are served from AuctionTime, the same platform.

Parameter		Allowed / range	Description
lot_id	optional	—	The lot's id (lots[].lot_id).
url	optional	—	A lot URL (lots[].url) instead of lot_id.

Try in playground →

post/equipmentfacts/v1/search1 credit

Search lots across every Equipment Facts auction by keyword, manufacturer, category, year range, state, country, condition, auction type or auction date. Each row is a lot with its specs, hours / mileage, photos, location, auction and the live bid state; 28 per page with the site's own total.

Parameter		Allowed / range	Description
query	optional	—	Words to search lots for.
manufacturer	optional	—	Manufacturer, as the site spells it.
category	optional	—	Category id (filters facet=category; 1031 = Excavators).
year_min	optional	—	Earliest year.
year_max	optional	—	Latest year.
state	optional	—	US state or Canadian province, by name or 2-letter code (TX).
country	optional	—	USA, Canada or Mexico.
condition	optional	used · new · salvaged · rebuilt	Condition.
auction_type	optional	online · onsite	online = timed online sales (AuctionTime); onsite = live on-site / webcast auctions.
auction_date	optional	—	Only lots selling on this date (YYYY-MM-DD).
status = upcoming	optional	upcoming · past	Upcoming auctions (default) or past auctions (auction results).
sort = recently_added	optional	recently_added · relevance · lot_number · year_asc · year_desc · manufacturer · model · recently_updated	Order of results. The default pages completely; the site's relevance order repeats and skips rows from page to page.
page = 1	optional	1–2000	Page, from 1.
include_bids = true	optional	—	Read the live bid state (current bid, next bid, increment, bid count on online sales, closing time) from the site's bid service: one extra small request. false = only what the lot list carries.

Try in playground →

post/equipmentfacts/v1/filters1 credit

The site's own filter values with counts — categories (with their ids), states, countries, conditions, auction types, auction dates or manufacturers — for upcoming lots or auctions. Use the values in auctions / search.

Parameter		Allowed / range	Description
facet	required	category · state · country · condition · auction_type · auction_date · manufacturer	Which filter. Auctions scope supports state, auction_type, auction_date.
scope = lots	optional	lots · auctions	Count lots or auctions.
status = upcoming	optional	upcoming · past	Upcoming auctions (default) or past auctions (auction results).
query	optional	—	Only count matches for these words.

Try in playground →

Example request · auctions

curl -X POST https://api.reefapi.com/equipmentfacts/v1/auctions \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"page":1}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Built for volume

5M+ requests a day

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.

Missing a source?

We build it

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.

Support

2 minute median reply

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.

One key, one balance

Every API included

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.