# Auction.com · Search listings

Search 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.

- Provider: Alexandria
- Category: Listings
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `auction-com/real-estate-auctions/search_listings`
- Page: https://spiral.ai/tools/alexandria/auction-com/real-estate-auctions/search_listings

## Pricing

$0.00873 per call.

## Limits

- 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 | Allowed | 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 |

## Example

```bash
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>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=auction-com%2Freal-estate-auctions%2Fsearch_listings

## Common questions

### Auction.com · Search listings

**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.

