# Auction.com Ad

## Overview

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

## Description

Get full details for an auction.com property listing including specs, opening bid, auction dates, photos, and financing availability.

## 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Bank-owned Chicago property

```json
{
  "id": "2037268",
  "url": "https://www.auction.com/details/638-e-91st-st-chicago-il-2037268",
  "beds": 2,
  "sqft": 846,
  "baths": 1,
  "state": "IL",
  "county": "COOK COUNTY",
  "photos": [
    "https://adc-tenbox-prod.imgix.net/resi/propertyImages/755499/755499_ext_1.v1.jpeg?auto=compress,format",
    "https://adc-tenbox-prod.imgix.net/resi/propertyImages/755499/755499_int_1.v1.jpeg?auto=compress,format",
    "https://adc-tenbox-prod.imgix.net/resi/propertyImages/755499/755499_int_2.v1.jpeg?auto=compress,format"
  ],
  "status": "May 12 - May 14, 2026",
  "address": "638 E 91ST ST, CHICAGO, IL 60619, COOK COUNTY",
  "latitude": 41.7267,
  "lot_sqft": 0.07,
  "longitude": -87.6059,
  "sale_type": "Bank Owned",
  "year_built": 1922,
  "description": "2-bedroom, 1-bath single-family home located in Chicago's Chatham neighborhood. Built in 1922, this 846 sq ft property sits on a 0.07-acre lot. Property is bank-owned and sold as-is. Interior inspection available during scheduled showing windows.",
  "opening_bid": 35000,
  "postal_code": "60619",
  "auction_date": "2026-05-12",
  "auction_time": "12:00",
  "municipality": "CHICAGO",
  "property_type": "SINGLE_FAMILY_HOME",
  "auction_end_date": "2026-05-14T14:10:00Z",
  "auction_location": "Online Auction",
  "est_resale_value": 87000,
  "occupancy_status": "VACANT",
  "broker_commission": 2.5,
  "auction_start_date": "2026-05-12T12:00:00Z",
  "street_description": "638 E 91ST ST",
  "financing_available": true,
  "property_type_group": "SINGLE_FAMILY",
  "starting_bid_amount": 35000,
  "is_reserve_displayed": null,
  "listing_photos_count": 8,
  "is_first_look_enabled": true,
  "buyer_premium_available": false,
  "interior_access_allowed": true,
  "is_direct_offer_enabled": false
}
```

### Foreclosure Miami property

```json
{
  "id": "2041895",
  "url": "https://www.auction.com/details/1247-nw-12th-ave-miami-fl-2041895",
  "beds": 3,
  "sqft": 1340,
  "baths": 2,
  "state": "FL",
  "county": "MIAMI-DADE COUNTY",
  "photos": [
    "https://adc-tenbox-prod.imgix.net/resi/propertyImages/812341/812341_ext_1.v1.jpeg?auto=compress,format",
    "https://adc-tenbox-prod.imgix.net/resi/propertyImages/812341/812341_ext_2.v1.jpeg?auto=compress,format"
  ],
  "status": "May 15 - May 17, 2026",
  "address": "1247 NW 12TH AVE, MIAMI, FL 33136, MIAMI-DADE COUNTY",
  "latitude": 25.7849,
  "lot_sqft": 0.12,
  "longitude": -80.2148,
  "sale_type": "Foreclosure",
  "year_built": 1958,
  "description": "3-bedroom, 2-bath single-family home in Miami. Built in 1958. Property is occupied and sold as-is with no interior access. Foreclosure sale, buyer premium applies.",
  "opening_bid": 89000,
  "postal_code": "33136",
  "auction_date": "2026-05-15",
  "auction_time": "14:00",
  "municipality": "MIAMI",
  "property_type": "SINGLE_FAMILY_HOME",
  "auction_end_date": "2026-05-17T16:00:00Z",
  "auction_location": "Online Auction",
  "est_resale_value": 245000,
  "occupancy_status": "OCCUPIED",
  "broker_commission": null,
  "auction_start_date": "2026-05-15T14:00:00Z",
  "street_description": "1247 NW 12TH AVE",
  "financing_available": false,
  "property_type_group": "SINGLE_FAMILY",
  "starting_bid_amount": 89000,
  "is_reserve_displayed": null,
  "listing_photos_count": 4,
  "is_first_look_enabled": false,
  "buyer_premium_available": true,
  "interior_access_allowed": false,
  "is_direct_offer_enabled": false
}
```

## Documentation

## Overview
Get full property details from an auction.com listing: address, beds, baths, sqft, opening bid, estimated resale value, auction window, financing, broker commission, occupancy, and all photos.

## Quickstart
```
GET https://api.piloterr.com/v2/auction/ad?url=https://www.auction.com/details/638-e-91st-st-chicago-il-2037268
```

## Main use cases
- Pull full property specs for due diligence before bidding
- Enrich investment databases with complete listing data
- Monitor individual listings for status and bid window changes
- Automate comparable market analysis
- Build investor-facing deal flow platforms

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