auction.com APIauction.com ↗
Access Auction.com property listings, auction events, foreclosure data, valuations, and photos via 11 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/200ed879-94e5-4eda-a41a-c308e888c8ff/search_properties?limit=5&offset=0&location=CA' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings on Auction.com. Returns paginated results with listing details including address, auction dates, pricing, and property summaries.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order for results |
| limit | integer | Max results per page |
| offset | integer | Pagination offset |
| location | string | State code (e.g. 'CA', 'TX') or free-text search location |
| listing_type | string | Listing type filter (e.g. 'active') |
{
"type": "object",
"fields": {
"size": "integer number of results returned in this page",
"content": "array of listing objects with property details, auction info, and pricing",
"total_count": "integer total number of matching listings"
},
"sample": {
"data": {
"size": 5,
"content": [
{
"auction": {
"start_date": "2026-05-28T16:00:00Z"
},
"listing_id": "2060595",
"listing_status": "SALE_PENDING",
"primary_property": {
"summary": {
"square_footage": 1582,
"total_bedrooms": 3,
"total_bathrooms": 2
},
"property_id": "834672"
},
"formatted_address": [
"7968 Fairchild Ave",
"Los Angeles, CA 91306, Los Angeles County"
],
"listing_configuration": {
"asset_type": "FORECLOSURE"
}
}
],
"total_count": 2382
},
"status": "success"
}
}About the auction.com API
The Auction.com API provides access to 11 endpoints covering property listings, auction events, market valuations, and photos from Auction.com. The search_properties endpoint returns paginated results with address, pricing, and auction dates across the full inventory, while dedicated endpoints expose foreclosure listings, bank-owned properties, private seller listings, and an upcoming auction calendar with per-event detail—all as structured JSON.
Property Search and Listing Detail
The search_properties endpoint accepts a location parameter (state code like CA or free-text), a listing_type filter, and standard limit/offset pagination. Each result in the content array includes property address, auction dates, and pricing. For full detail on any listing, get_property_details accepts either a listing_id or a url_slug and returns the active_listings array with photos, documents, remarks, venue information, and a recommended_listings array of similar properties. get_property_photos returns an array of CDN URL strings directly.
Auction Events and Calendar
The get_auction_calendar endpoint returns paginated auction events sorted by campaign start date. Each event object includes an event_code, a title, a listing_count, and venue details. Passing an event_code to get_auction_event_details returns the specific property listings within that event, with their own pagination via limit and offset. This makes it straightforward to enumerate all active auctions and drill into individual events.
Listing Type Filters and Valuations
Three dedicated search endpoints segment the inventory by seller type: get_foreclosure_listings, get_bank_owned_listings, and get_private_seller_listings. All three share the same location, sort, limit, and offset parameters and return the same content / total_count / size shape. For active listings, get_market_analysis accepts a listing_id and returns a summary array with estimated, low, and high valuation fields along with a type label. The comparables field is returned when available but may be null.
Location Autocomplete
The get_autocomplete_suggestions endpoint accepts a query string and returns location suggestions covering cities, counties, states, and ZIP codes. Each suggestion object includes value, city, county, state, zip, type, and coordinates—useful for building location-aware search interfaces that align with how Auction.com resolves location strings.
- Monitor new foreclosure listings by state using
get_foreclosure_listingswith alocationfilter and scheduled polling. - Build an auction event tracker by pulling
get_auction_calendarand enriching each event withget_auction_event_details. - Display property photos in a listing app by fetching CDN URLs from
get_property_photos. - Estimate distressed property values by combining
get_market_analysissummary with comparable listing prices fromsearch_properties. - Surface similar properties on a listing detail page using the
recommended_listingsarray fromget_property_details. - Power a location search autocomplete widget with city, county, state, and ZIP suggestions from
get_autocomplete_suggestions. - Segment inventory by seller type—bank-owned, foreclosure, or private seller—using the three dedicated listing endpoints.
| 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 Auction.com have an official developer API?+
What does `get_market_analysis` return, and are comparables always available?+
summary array with estimated, low, high, and type valuation fields for the specified active listing. The comparables field is included in the response but may be null depending on the listing.Can I retrieve historical auction results or sold property data?+
How do `get_foreclosure_listings` and `get_bank_owned_listings` differ?+
get_foreclosure_listings filters to foreclosure and bank-owned properties as a combined set. get_bank_owned_listings targets bank-owned and foreclosure properties specifically. In practice both cover similar inventory segments; use both and compare total_count values for a given location to see any difference for your query.Is county-level or ZIP-level search supported in `search_properties`?+
location parameter accepts state codes and free-text strings. County and ZIP-level targeting is not a dedicated parameter in search_properties. The get_autocomplete_suggestions endpoint does resolve ZIP codes and counties, and the returned suggestion values can be passed as the location string to refine results.