# Auction.com Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/auction/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/auction-search |

## Description

Search auction.com residential property listings and get address, beds, baths, opening bid, sale type, and auction dates as JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/auction/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search Chicago IL properties

```json
{
  "page": 1,
  "results": [
    {
      "id": "2037268",
      "url": "https://www.auction.com/details/638-e-91st-st-chicago-il-2037268",
      "beds": 2,
      "sqft": 846,
      "baths": 1,
      "state": "IL",
      "status": "May 12 - May 14, 2026",
      "address": "638 E 91ST ST, CHICAGO, IL 60619, COOK COUNTY",
      "sale_type": "Bank Owned",
      "year_built": 1922,
      "opening_bid": 35000,
      "postal_code": "60619",
      "municipality": "CHICAGO",
      "property_type": "SINGLE_FAMILY_HOME",
      "auction_end_date": "2026-05-14T14:00:00Z",
      "auction_location": "Online Auction",
      "occupancy_status": "VACANT",
      "primary_photo_url": "https://adc-tenbox-prod.imgix.net/resi/propertyImages/755499/755499_ext_1.v1.jpeg?auto=compress,format",
      "auction_start_date": "2026-05-12T12:00:00Z",
      "financing_available": true,
      "buyer_premium_available": false
    },
    {
      "id": "2041895",
      "url": "https://www.auction.com/details/1247-nw-12th-ave-miami-fl-2041895",
      "beds": 3,
      "sqft": 1340,
      "baths": 2,
      "state": "FL",
      "status": "May 15 - May 17, 2026",
      "address": "1247 NW 12TH AVE, MIAMI, FL 33136, MIAMI-DADE COUNTY",
      "sale_type": "Foreclosure",
      "year_built": 1958,
      "opening_bid": 89000,
      "postal_code": "33136",
      "municipality": "MIAMI",
      "property_type": "SINGLE_FAMILY_HOME",
      "auction_end_date": "2026-05-17T16:00:00Z",
      "auction_location": "Online Auction",
      "occupancy_status": "OCCUPIED",
      "primary_photo_url": "https://adc-tenbox-prod.imgix.net/resi/propertyImages/812341/812341_ext_1.v1.jpeg?auto=compress,format",
      "auction_start_date": "2026-05-15T14:00:00Z",
      "financing_available": false,
      "buyer_premium_available": true
    }
  ],
  "total_pages": 62,
  "total_results": 1482
}
```

### Search Florida bank-owned 3+ beds

```json
{
  "page": 1,
  "results": [
    {
      "id": "2049312",
      "url": "https://www.auction.com/details/4502-sw-23rd-st-orlando-fl-2049312",
      "beds": 4,
      "sqft": 1780,
      "baths": 2,
      "state": "FL",
      "status": "May 20 - May 22, 2026",
      "address": "4502 SW 23RD ST, ORLANDO, FL 32811, ORANGE COUNTY",
      "sale_type": "Bank Owned",
      "year_built": 1984,
      "opening_bid": 112000,
      "postal_code": "32811",
      "municipality": "ORLANDO",
      "property_type": "SINGLE_FAMILY_HOME",
      "auction_end_date": "2026-05-22T15:00:00Z",
      "auction_location": "Online Auction",
      "occupancy_status": "VACANT",
      "primary_photo_url": "https://adc-tenbox-prod.imgix.net/resi/propertyImages/901234/901234_ext_1.v1.jpeg?auto=compress,format",
      "auction_start_date": "2026-05-20T13:00:00Z",
      "financing_available": true,
      "buyer_premium_available": false
    }
  ],
  "total_pages": 23,
  "total_results": 543
}
```

## Documentation

## Overview
Auction.com is the largest online real estate auction marketplace in the US, listing bank-owned, foreclosure, and coming-soon properties across all 50 states. Piloterr handles Cloudflare bypass and returns structured JSON.

## Quickstart
```
GET https://api.piloterr.com/v2/auction/search?query=Chicago+IL
```

## Main use cases
- Source distressed properties for wholesale or fix-and-flip pipelines
- Monitor opening bids and auction windows by geography
- Build automated alerts for specific criteria (beds, price, state)
- Enrich CRM records with live auction data for investor prospecting
- Aggregate inventory to compare market depth across states

Get access at https://www.piloterr.com/pricing