Auction.com · Search listings
auction-com/real-estate-auctions/search_listingsSearch property, job and marketplace listings with Auction.com · Search listings from Alexandria through one Spiral API key. Finding auction properties in an area; listing sold (closed) auctions with winning bids; locating a listing_id for get_listing, get_valuation or get_auction_status. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
zip | text | — | Five-digit ZIP code. Pattern: ^[0-9]{5}$. |
city | text | — | City name, for example Atlanta. Combine with state. |
sort | one of auction_date_order, asset_activation_dt_sort_desc, valuation_estimate, valuation_estimate desc, sqft, sqft desc, resi_sort_v2, recommended_v2 | auction_date_order | Site sort keys: auction date (default), newly added, price low-high / high-low, sqft low-high / high-low, recommended. |
limit | number 1 to 100 | 20 | Page size. |
query | text | — | Free text (address, ZIP, city) sent to the site's search box filter. |
state | text | — | Two-letter US state code, for example GA. Pattern: ^[A-Za-z]{2}$. |
county | text | — | County name without the word County, for example Miami-Dade. Combine with state. |
offset | number 0 to 100000 | 0 | Continuation: pass next_offset from the previous page. |
beds_min | number 0 to 20 | — | beds_min |
sqft_max | number 0 to 1000000 | — | sqft_max |
sqft_min | number 0 to 1000000 | — | sqft_min |
baths_min | number 0 to 20 | — | baths_min |
price_max | number 0 to 1000000000 | — | USD |
price_min | number 0 to 1000000000 | — | USD |
asset_type | list | — | Asset classes (site filter 'Asset type'). |
listing_type | list | — | Listing states to include. closed means sold. Defaults to ["active"]. |
property_type | list | — | property_type |
auction_format | one of online, in_person | — | auction_format |
year_built_min | number 1600 to 2100 | — | year_built_min |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "auction-com/real-estate-auctions/search_listings",
"input": {
"zip": "<zip>"
}
}'Frequently asked questions
How much does Auction.com · Search listings cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Auction.com · Search listings through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "auction-com/real-estate-auctions/search_listings"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use Auction.com · Search listings?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Auction.com · Search listings?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.