AuctionZip APIauctionzip.com ↗
Access AuctionZip auction lots, historical prices realized, auction catalogs, auctioneers, and the auction calendar via a structured REST API.
What is the AuctionZip API?
The AuctionZip API provides 8 endpoints covering auction lot search, detailed lot metadata, full auction catalogs, historical prices realized, and auctioneer discovery. Call search_lots to find online bidding lots by keyword and receive paginated results with lot_ref values you can chain into get_lot_detail for pricing, condition, photos, and buyer premium calculations. The API also exposes the live auction calendar and ranked auctioneer data.
curl -X GET 'https://api.parse.bot/scraper/11e1e413-bcac-4943-b189-7c09df774bdb/search_lots?page=1&query=antique' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace auctionzip-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
AuctionZip API - Search lots, browse auctions, and discover auctioneers.
"""
from parse_apis.auctionzip_api import AuctionZip, LotSummary, Catalog, TopAuctioneer
client = AuctionZip()
# Search for lots and iterate results
for lot in client.lots.search(query="tractor", limit=5):
print(lot.lot_ref, lot.title, lot.url)
# Get a catalog by ref and fetch its auction terms
catalog = client.catalog(ref="LQJPRLJYWW")
terms = catalog.terms()
print(terms.auction_bidding_fee_text, terms.auction_shipping_text)
for entry in terms.auction_terms:
print(entry.terms_title, entry.terms_text)
# Browse the auction calendar for a given month
for day in client.auctions.calendar(month="7", year="2026"):
print(day.day, day.auction_count, day.url)
# Search for auctioneers
for auctioneer in client.auctioneers.search(query="bertoia"):
print(auctioneer.name, auctioneer.url)
# Get this week's top auctioneers
for top in client.auctioneers.top(limit=3):
print(top.rank, top.name, top.location, top.phone)
# Look up historical prices
for record in client.pricerecords.search(keywords="chair", limit=5):
print(record.title, record.price)
Full-text search over online bidding lots. Returns paginated results with lot references, titles, and URLs. Each lot_ref can be passed to get_lot_detail for full metadata.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results |
| queryrequired | string | Search keyword for lot titles |
{
"type": "object",
"fields": {
"lots": "array of lot summary 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/british-diecast-tractor-unit_3E4ABB66F6",
"title": "Lot 110:British diecast Tractor Unit",
"lot_ref": "3E4ABB66F6"
}
],
"page": "1",
"query": "tractor",
"total_found": 60
},
"status": "success"
}
}About the AuctionZip API
Lot Search and Detail
search_lots accepts a query string and an optional page integer, returning an array of lot summary objects each with a lot_ref, title, and url. The total_found field tells you how many matching lots exist across all pages. Pass any lot_ref to get_lot_detail to retrieve the full itemView object: title, description, price, currency, photos, estimateLow, estimateHigh, condition, and catalogRef. The dynamicPricing field provides buyer-premium calculations when the auction applies a tiered fee schedule.
Auction Catalogs and Terms
The catalogRef from a lot detail response feeds directly into get_auction_catalog, which returns the auction's catalogTitle, eventDate (Unix timestamp in milliseconds), location address object, sellerModel, and the groupModel containing buyer premiums and bid increments. For full terms-of-sale text, call get_auction_details with the same catalog_ref; it returns auctionTerms, auctionShippingText, auctionBuyersPremiums tier array, auctionBiddingIncrements, and auctionPaymentMethodsText.
Calendar, Auctioneers, and Prices Realized
search_auctions doubles as a calendar and a listing endpoint. Without a day parameter it returns a days array with per-day auction_count values for the chosen month and year. Add a day value and it switches to view: list, returning auction titles and URLs. Optional zip and keywords parameters narrow results by proximity or topic. get_prices_realized accepts keywords and an optional category_id and returns up to 20 historical sale records with title and price. get_top_auctioneers needs no inputs and returns this week's top 10 most-viewed auctioneers with rank, name, location, and phone. search_auctioneers accepts a query and optional zip to find auctioneer profiles by company name or last name.
The AuctionZip API is a managed, monitored endpoint for auctionzip.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when auctionzip.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official auctionzip.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price-research tool that queries
get_prices_realizedby keyword to show historical hammer prices for antiques or collectibles. - Aggregate the weekly auction calendar with
search_auctionsto surface upcoming sales filtered by ZIP code proximity. - Track lot estimates versus final prices by pairing
get_lot_detailestimateLow/estimateHighwithpricefields. - Display full buyer premium tiers from
get_auction_detailsbefore a bidder places a bid, so they know the true cost. - Index auctioneer contact info and rankings from
get_top_auctioneersto build a directory of active auction houses. - Chain
search_lotsintoget_lot_detailandget_auction_catalogto build a structured feed of currently active online lots with location data. - Alert users when specific keywords appear in new auction lots by polling
search_lotsand comparingtotal_foundover time.
| 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 | 100 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_lot_detail` return beyond the title and price?+
get_lot_detail returns the full itemView object which includes description, photos array, estimateLow, estimateHigh, condition, currency, and catalogRef. It also includes a dynamicPricing object with buyer-premium calculations, and a _links object pointing to the catalog and the lot's own URL.How many historical price records does `get_prices_realized` return per request?+
title and a price. Pagination and date-range filtering are not currently supported. You can fork the API on Parse and revise it to add pagination or date-scoped queries if your use case requires more records.Does the API expose individual bidder data or bidding history on a lot?+
get_lot_detail returns the current price and buyer premium structure from dynamicPricing, but not a list of individual bids or bidder accounts. You can fork the API on Parse and revise it to surface any additional bid-level fields if they become accessible.Can I filter `search_lots` results by category, location, or price range?+
search_lots currently accepts only a query keyword string and a page number. Category, location, and price-range filters are not available on this endpoint. You can fork the API on Parse and revise it to add those filter parameters.