AutoBidMaster APIautobidmaster.com ↗
Access AutoBidMaster vehicle auction data via API. Search Copart lots by make, model, state, damage type, and get full lot details including images, VIN, and bid status.
What is the AutoBidMaster API?
The AutoBidMaster API provides access to vehicle auction inventory across 9 endpoints, covering everything from paginated lot search results to full per-lot details. The search_vehicles endpoint accepts filters like make, model, state, and free text, returning summaries with year, damage, high bid, sale date, and location. Companion endpoints expose filter metadata — makes, body styles, damage types, and auction yard locations — with live listing counts.
curl -X GET 'https://api.parse.bot/scraper/c6fd4d1b-7ed8-49b8-b5f2-a977ec97f6ed/search_vehicles?make=toyota&page=1&size=24&sort=sale_date&model=camry&order=asc&query=toyota&state=texas&country=usa' \ -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 autobidmaster-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.
"""AutoBidMaster auction SDK — search lots, get details, browse filters."""
from parse_apis.autobidmaster_api import AutoBidMaster, Direction, Country, LotNotFound
client = AutoBidMaster()
# Browse popular vehicle makes to understand inventory distribution
for make in client.makes.list(limit=5):
print(make.label, make.cnt)
# Search Toyota lots in the USA sorted by ascending sale date
lot = client.lots.search(make="toyota", country=Country.USA, order=Direction.ASC, limit=1).first()
if lot:
print(lot.year, lot.make, lot.model, lot.primary_damage, lot.high_bid)
# Get full details for that lot (panoramas, location coordinates, title info)
if lot:
try:
detail = client.lots.get(lot_number=str(lot.lot_number))
print(detail.description, detail.odometer, detail.engine_size, detail.location_name)
except LotNotFound as exc:
print(f"Lot gone: {exc}")
# List damage types to see available filter categories
for dt in client.damagetypes.list(limit=5):
print(dt.label, dt.cnt)
# List auction locations across US and Canada
for loc in client.locations.list(limit=5):
print(loc.label, loc.cnt)
print("exercised: makes.list / lots.search / lots.get / damagetypes.list / locations.list")
Search vehicle auction listings with optional filters. Returns paginated lot summaries including year, make, model, damage, bid status, sale date, and location. Supports filtering by make, model, country, state, and free text. Pagination via page number; each page returns up to `size` lots. Sort by sale_date (default) or other fields.
| Param | Type | Description |
|---|---|---|
| make | string | Vehicle make filter in lowercase (e.g., toyota, honda, ford). |
| page | integer | Page number (1-based). |
| size | integer | Results per page (max 100). |
| sort | string | Sort field. Currently only 'sale_date' is supported. |
| model | string | Vehicle model filter in lowercase (e.g., camry, civic, f-150). |
| order | string | Sort order: asc or desc. |
| query | string | Free text search query. |
| state | string | State filter in lowercase (e.g., california, texas, new-york). |
| country | string | Country filter in lowercase. Accepted values: usa, canada. |
{
"type": "object",
"fields": {
"lots": "array of vehicle listing summary objects with year, make, model, lotNumber, primaryDamage, highBid, saleDate, location etc.",
"query": "object containing pagination metadata (page, size, start, maxNumberOfPages)",
"total": "integer total number of matching results"
},
"sample": {
"data": {
"lots": [
{
"id": 51710376,
"vin": "2HGFC2F67MH******",
"make": "Honda",
"slug": "copart-2021-honda-civic-t-of-title-salvage-north-boston-ma",
"sold": false,
"year": 2021,
"color": "Black",
"model": "Civic",
"source": "copart_direct",
"highBid": 2350,
"currency": "USD",
"odometer": 74131,
"bodyStyle": "Sedan",
"lotNumber": 51710376,
"saleStatus": "P",
"description": "2021 Honda Civic Lx",
"locationName": "MA - North Boston",
"primaryDamage": "Front End",
"inventoryAuction": "Copart"
}
],
"query": {
"page": 1,
"size": 3,
"start": 0,
"searchAfter": null,
"maxNumberOfPages": 3333
},
"total": 12178
},
"status": "success"
}
}About the AutoBidMaster API
Search and Filter Auction Inventory
The search_vehicles endpoint is the primary entry point. It accepts optional parameters including make, model, state, query, sort (currently sale_date), and order (asc/desc). Results are paginated using page and size (up to 100 per page). Each lot summary in the lots array includes year, make, model, lotNumber, primaryDamage, highBid, saleDate, and location. The response also returns a query object with pagination metadata (page, size, start, maxNumberOfPages) and a total integer count of matching results.
Full Lot Details
get_vehicle_details accepts a lot_number (obtained from search_vehicles results) and returns the complete record for that auction lot. Fields include vin, images, panoramas, damage, title status, sale info, odometer, engine specs, location coordinates, and current bid data. The auction parameter currently accepts only copart as a value.
Filter Metadata Endpoints
Six dedicated endpoints return categorized inventory counts useful for building filter UIs or understanding coverage. get_popular_makes returns all makes sorted by listing volume, each with a key, label, and cnt. get_vehicle_types and get_body_styles break inventory down by vehicle category (Cars, Motorcycles, ATVs, etc.) and body style (Sedan, SUV, Hatchback, etc.). get_damage_types lists damage classifications like Front End, Hail, and Rollover with counts. get_auction_locations returns yard locations across the US and Canada identified by state/province code and city slug. get_featured_items exposes curated categories such as Clean Title, Buy It Now, Electric, and Insurance lots, including a filterSection identifier for each.
Homepage Inventory Summary
get_homepage_inventory returns a combined snapshot of popular makes, featured categories, and vehicle types, each with a label, cnt, and navigation link. This is useful for building landing pages or quick-reference dashboards without issuing multiple separate calls to the metadata endpoints.
The AutoBidMaster API is a managed, monitored endpoint for autobidmaster.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when autobidmaster.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 autobidmaster.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?+
- Monitor sale dates and high bids for specific makes and models to identify buying windows
- Build a damage-type filter UI using live counts from
get_damage_types - Pull full VIN, odometer, and engine specs via
get_vehicle_detailsfor insurance or valuation workflows - Aggregate auction lot counts by location using
get_auction_locationsto map regional inventory density - Track availability of Electric and Hybrid lots using
get_featured_itemscategory counts - Seed a used-vehicle search tool with make options and listing counts from
get_popular_makes - Alert users when a specific make/model/state combination has new lots via periodic
search_vehiclespolling
| 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 AutoBidMaster have an official developer API?+
What does `search_vehicles` return, and how do I narrow results by location?+
lots array includes year, make, model, lotNumber, primaryDamage, highBid, saleDate, and location. To filter by location, pass a lowercase state name to the state parameter (e.g., california, new-york). Combine it with make and model to narrow further. Pagination is controlled via page and size (max 100 per page), and the query object in the response gives you maxNumberOfPages to step through full result sets.Does the API support sorting by fields other than sale date?+
sort parameter in search_vehicles only accepts sale_date. Sorting by high bid, odometer, or year is not exposed. You can fork this API on Parse and revise it to add additional sort options if the underlying data supports them.Does the API cover auctions other than Copart?+
get_vehicle_details endpoint currently accepts only copart as the auction parameter value, and inventory in search_vehicles reflects Copart lots available through AutoBidMaster. Other auction sources are not included. You can fork this API on Parse and revise it to add endpoints targeting additional auction sources.Are bid history or individual bidder records returned by any endpoint?+
get_vehicle_details includes current bid data for a lot (such as high bid), but the full bidding history is not exposed. You can fork this API on Parse and revise it to add a bid history endpoint if that data is accessible for a given lot.