# Auction.com Residential Property Listings Scraper

> Auction.com Residential Property Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured residential auction property listings from Auction.com, returning normalized listing data by location (state, city, or direct URL).

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/auction?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/auction-com-residential-property-listings-scraper-d9b91d6e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KsGmv6lB7xxjWU7KJx2sE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability auction-com-residential-property-listings-scraper-d9b91d6e -d '<json body>'
```

Example prompt: Can you pull up to 50 residential auction listings from Auction.com for properties in Austin, Texas and give me the addresses, photos, and ZIP codes?

## When to prefer this

Use this endpoint when you need structured, normalized auction property listing data from Auction.com specifically, particularly for residential foreclosure or bank-owned property research by state, city, or direct search URL. Prefer this over generic web scrapers when you need consistently shaped property records (address, ZIP, photo, county) without parsing raw HTML.

## Known failure modes

- Empty result set if no listings match the location criteria (not charged)
- Invalid state code returns no results
- Malformed or non-Auction.com startUrls may yield empty or error responses
- maxItems cap reached before all available listings are retrieved
- Service unavailable if Auction.com blocks scraping temporarily

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object with a count of results and an array of listing items, each containing the property's internal ID, listing URL, full address, postal code, municipality, primary photo URL, state, and county. The product field identifies the data type as 'auction'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Stop after this many unique listings."
  },
  "startUrls": {
   "type": "array",
   "description": "HTTPS Auction.com residential search URLs scoped by state, city, county, or ZIP, or direct property detail URLs. Search URL listing type and auction format suffixes are applied after detail checks."
  },
  "propertyCity": {
   "type": "string",
   "description": "City name used with propertyState when startUrls is empty."
  },
  "propertyState": {
   "type": "string",
   "description": "Two-letter state code used when startUrls is empty."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "address": null,
    "postal_code": null,
    "municipality": null,
    "primary_photo_url": null,
    "country_primary_subdivision": null,
    "country_secondary_subdivision": null
   }
  ],
  "product": "auction"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/auction-com-residential-property-listings-scraper-d9b91d6e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)