auctionzip.com APIauctionzip.com ↗
Access AuctionZip auction lots, catalog metadata, historical prices realized, auctioneer search, and auction calendars via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/11e1e413-bcac-4943-b189-7c09df774bdb/search_lots?query=tractor' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for online bidding lots by keyword. Returns a paginated list of lots with their references, titles, and URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results |
| queryrequired | string | Search keyword for lot titles |
{
"type": "object",
"fields": {
"lots": "array of lot objects with lot_ref, title, and url",
"page": "string, the requested page number",
"query": "string, the search query echoed back",
"total_found": "integer, total number of matching lots"
},
"sample": {
"data": {
"lots": [
{
"url": "https://www.auctionzip.com/auction-lot/consolidated-freightways-tractor-and-trailer_DBF0777108",
"title": "Lot 29:Consolidated Freightways Tractor and Trailer",
"lot_ref": "DBF0777108"
}
],
"page": "1",
"query": "tractor",
"total_found": 60
},
"status": "success"
}
}About the auctionzip.com API
The AuctionZip API provides 8 endpoints covering auction lot search, full lot detail, catalog metadata, auction terms, auction calendar, historical prices realized, and auctioneer discovery. The get_lot_detail endpoint returns pricing, high/low estimates, condition notes, and photo URLs for a specific lot, while get_prices_realized gives historical sold prices for any keyword search across AuctionZip's marketplace.
Lot Search and Detail
The search_lots endpoint accepts a query string and an optional page integer, returning a paginated list of lot objects — each with a lot_ref, title, and url. Pass any lot_ref to get_lot_detail to retrieve the full itemView object, which includes title, description, price, currency, photos, estimateLow, estimateHigh, condition, and a catalogRef linking back to the parent auction. A dynamicPricing object provides buyer's premium calculations, and the response returns stale_input if the lot reference is no longer active.
Auction Catalogs and Terms
With a catalogRef from any lot detail, get_auction_catalog returns the full catalog: catalogTitle, eventDate (Unix timestamp in milliseconds), a location object with address fields, sellerModel with auction house information, and a groupModel containing buyer's premiums and bid increments. get_auction_details targets the same catalog_ref but returns the legal and operational layer — an auctionTerms array (each with termsType, termsTitle, and termsText), auctionShippingText, auctionPaymentMethodsText, auctionBiddingIncrements, and tiered auctionBuyersPremiums.
Auction Calendar and Auctioneer Search
search_auctions operates in two modes. Without a day parameter it returns a calendar view — an array of days objects each carrying day, month, year, auction_count, and a url. Add a day value (1–31) alongside optional year, month, zip, and keywords filters to switch to list view, returning an auctions array of title/url pairs. search_auctioneers queries by company name or last name and optionally filters by zip, returning a list of auctioneer names and profile URLs. get_top_auctioneers requires no inputs and returns this week's top 10 most-viewed auctioneers with rank, name, location, and phone.
Historical Prices Realized
get_prices_realized accepts a keywords string and an optional category_id integer (use 0 for all categories). It returns up to 20 items, each with a title and price, drawn from historical sold records on AuctionZip. This endpoint is useful for quick comparables but does not return sale date, lot reference, or auction house per record.
- Build a price comparison tool for antiques and collectibles using
get_prices_realizedsold price records - Aggregate upcoming auction listings by ZIP code and date using
search_auctionswithzipanddayfilters - Display full lot detail pages — photos, estimates, condition, and buyer's premium — using
get_lot_detail - Populate an auctioneer directory with name, location, and phone from
get_top_auctioneersandsearch_auctioneers - Parse shipping, payment methods, and bid increments from
get_auction_detailsfor buyer-facing auction guides - Monitor auction catalog activity by chaining
search_lotsresults intoget_auction_catalogfor event date and seller info - Filter historical sold prices by category using the
category_idparameter inget_prices_realized
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AuctionZip have an official developer API?+
What does `get_prices_realized` actually return, and what are its limits?+
title and price field. The response does not include sale date, auction house name, lot reference, or category name — only the item title and the realized price. The category_id parameter (integer) can filter by category; passing 0 returns results across all categories.Does the auction calendar endpoint return individual lot listings?+
search_auctions in calendar mode returns day-level counts (auction_count) rather than individual lots. In list mode (with the day parameter set), it returns auction-level title and URL pairs, not individual lot records. Individual lots are accessible via search_lots with a keyword query. You can fork this API on Parse and revise it to add an endpoint that maps calendar days directly to their lots.Does `get_prices_realized` return the auction house or sale date for each record?+
title and price. Auction house identity and sale date are not included in the response. You can fork this API on Parse and revise it to add those fields if the source exposes them in another context.What happens if a lot reference or catalog reference is no longer active?+
get_lot_detail and get_auction_catalog (and get_auction_details) return a stale_input indicator when the provided reference is not found or has expired. Lot references are 10-character alphanumeric strings obtainable from search_lots; catalog references come from the catalogRef field in get_lot_detail responses.