AuctionTime APIauctiontime.com ↗
Access AuctionTime.com auction listings, sold results, categories, and auctioneer data via 9 structured API endpoints. Filter by category, date, or keyword.
What is the AuctionTime API?
The AuctionTime API exposes 9 endpoints covering live and sold equipment auction listings from AuctionTime.com, including full listing detail, category browsing, keyword search, and auctioneer profiles. The get_listing_detail endpoint returns per-item fields like current bid, sale end time, specs, location, images, and lot number. Together the endpoints cover discovery, bulk collection, and result tracking for agricultural and heavy equipment auctions.
curl -X GET 'https://api.parse.bot/scraper/2b8559b0-3f76-4719-9202-0a6145fc380f/get_listings?page=1&slug=tractors&category_id=1100' \ -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 auctiontime-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.
"""Walkthrough: AuctionTime SDK — browse categories, search listings, drill into details."""
from parse_apis.auctiontime_scraper_api import (
AuctionTime, Slug, CategoryId, ListingNotFound, Category
)
client = AuctionTime()
# Construct a category directly using enum members to browse tractors
tractors = Category(_api=client, id=CategoryId._1100, slug=Slug.TRACTORS)
for listing in tractors.listings(limit=3):
print(listing.title, listing.location, listing.lot_number)
# Search for equipment across all categories
result = client.listings.search(query="excavator", limit=3).first()
if result:
print(result.title, result.url)
# Fetch full detail for a specific listing
try:
detail = client.listings.get(listing_id="255572897")
print(detail.title, detail.listing_id)
except ListingNotFound as exc:
print(f"Listing not found: {exc}")
# Browse sold auction results for tractors category
for sold in tractors.auction_results(limit=3):
print(sold.title, sold.location)
# List auctioneers with contact info
for auctioneer in client.auctioneers.list(limit=3):
print(auctioneer.name, auctioneer.phone, auctioneer.items_sold)
# List all available categories
for cat in client.categories.list(limit=6):
print(cat.name, cat.id, cat.slug)
print("exercised: category.listings / listings.search / listings.get / category.auction_results / auctioneers.list / categories.list")
Fetch paginated auction listings for a category. Returns up to 28 listings per page with title, location, lot number, specs, and image. Use get_categories to discover valid slug/category_id pairs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number. |
| slugrequired | string | URL slug for the category (e.g., 'tractors', 'trucks', 'trailers'). |
| category_idrequired | string | Category ID (e.g., '1100' for tractors, '27' for trucks). |
{
"type": "object",
"fields": {
"listings": "array of listing objects with listing_id, title, url, lot_number, image_url, location, specs",
"total_pages": "integer total number of pages available"
},
"sample": {
"data": {
"listings": [
{
"url": "https://www.auctiontime.com/listing/upcoming-auctions/256333211/hyundai-crown-triton-ac-3-phase-engine",
"specs": {
"Condition": "Used",
"Serial Number": "HLS256SR235B"
},
"title": "HYUNDAI CROWN TRITON AC 3 PHASE Engine",
"location": "Hanceville, Alabama",
"image_url": "https://media.sandhills.com/CDN/Images/Icons/Miscellaneous/at-icon-white.png",
"listing_id": "256333211",
"lot_number": "9602"
}
],
"total_pages": 285
},
"status": "success"
}
}About the AuctionTime API
Browsing and Searching Listings
The get_listings endpoint fetches paginated auction listings for a specific category, identified by both a category_id (e.g., '1100' for tractors) and a URL slug. The search_listings endpoint accepts a free-text query string and returns matching listings across categories. Both return a listings array and a total_pages integer for pagination. If you need an entire category in one call, get_all_pages retrieves all pages at once and additionally returns a pages_fetched count.
Listing Detail and Auction Results
get_listing_detail takes a numeric listing_id and an optional URL slug, and returns a detail object with fields including title, description, category, specs, current_bid, sale_ends, location, images, image_url, url, and lot_number. For completed sales, get_auction_results returns sold listings for a given category using the same slug and category_id parameters. get_auction_by_date filters active listings to a specific auction date supplied in YYYY-MM-DD format.
Auctioneers and Categories
get_auctioneers returns a paginated list of auctioneer profiles, each including name, url, phone, address, items_sold, premier_seller status, and image_url. To pull listings for a single auctioneer, get_auctioneer_listings accepts an auctioneer_slug. The get_categories endpoint requires no inputs and returns all top-level categories with their id, slug, and name — useful for seeding category_id and slug values into the other endpoints.
The AuctionTime API is a managed, monitored endpoint for auctiontime.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when auctiontime.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 auctiontime.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?+
- Track current bids and sale end times on specific equipment listings using
get_listing_detail - Build a price history database for tractors and heavy equipment by collecting
get_auction_resultsacross categories - Monitor all auctions closing on a given day with
get_auction_by_dateto time procurement decisions - Aggregate auctioneer contact info, location, and items-sold counts from
get_auctioneersfor vendor research - Run keyword searches across AuctionTime inventory using
get_search_listingsto find specific makes or models - Bulk-collect an entire equipment category in one call via
get_all_pagesfor offline analysis - Filter live inventory by auctioneer using
get_auctioneer_listingsto follow preferred sellers
| 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 AuctionTime.com have an official developer API?+
What fields does `get_listing_detail` return beyond the bid price?+
detail object includes listing_id, title, description, category, specs (equipment specifications), current_bid, sale_ends, location, images (array), image_url, url, and lot_number. It does not include bidding history or individual bidder information.Does `get_auction_results` return final hammer prices or only the last known bid?+
Are subcategories supported, or only top-level categories?+
get_categories currently returns top-level categories with their id, slug, and name. Subcategory navigation is not covered by the current endpoints. You can fork the API on Parse and revise it to add a subcategory endpoint if you need finer-grained browsing.How should I get the `category_id` and `slug` values required by several endpoints?+
get_categories first — it requires no inputs and returns the full list of top-level categories with both id and slug for each. Pass those values directly into get_listings, get_all_pages, or get_auction_results.