Foreclosure Auction API by ZIP Code

Search foreclosure auctions by ZIP code

Use /zipcode/auction to search Auction.com listings around a US ZIP code. To include foreclosure and bank-owned listings from HUD HomeStore, Fannie Mae HomePath, Freddie Mac HomeSteps, and Redfin, use /zipcode/all.

Subscribe to Foreclosure Finder on RapidAPI and set RAPIDAPI_KEY to your subscribed application key in your terminal. Keep the key out of source control and browser code. This request works on BASIC. It searches ZIP 30067 within 25 miles and returns up to five listings, sorted by auction start date where available. The examples use curl 7.76 or newer.

Shell · BASIC or paid

export RAPIDAPI_KEY="YOUR_RAPIDAPI_KEY"

curl --fail-with-body --silent --show-error --max-time 65 \
  --get 'https://foreclosure-finder1.p.rapidapi.com/zipcode/auction' \
  --header "X-RapidAPI-Key: $RAPIDAPI_KEY" \
  --header 'X-RapidAPI-Host: foreclosure-finder1.p.rapidapi.com' \
  --data-urlencode 'zipcode=30067' \
  --data-urlencode 'radius=25' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'sort=auction_date'

Use a five-digit ZIP code and a whole-number radius from 1 to 100 miles. The response includes meta.totalCount for matches before pagination and listings for the requested page. To retrieve the next five rows, use the same search with offset=5. Inventory and ordering can change as the source updates.

Read opening bids, dates, and auction status

This abbreviated JSON is an illustration of the BASIC response shape. Its ID and values are examples. Use the values from your own search to inspect a listing.

JSON · illustrative excerpt

{
  "meta": { "totalCount": 1, "returned": 1 },
  "listings": [
    {
      "source": "auction",
      "listingId": "1234567",
      "openingBid": 75000,
      "assetType": "FORECLOSURE",
      "status": "COMING_SOON",
      "auctionDate": "2027-01-15T17:00:00Z"
    }
  ]
}

Field	What it tells you
openingBid	The source’s starting bid in dollars. It can be absent or a nominal amount. Standard price filters use this field.
auctionDate, status, statusLabel	The source’s reported start date and listing state, where supplied. Verify timing and status on the source page before acting.
assetType	The source’s asset category, such as FORECLOSURE or BANK_OWNED. Auction.com can return both.
propertyLink	The original Auction.com listing page, when available. Use this URL to verify the current event and terms.
bidding.currentHighBid, bidding.lastBidDate	The latest high bid and timestamp supplied in the paid response snapshot, when available.
auctionEndDate	The source’s reported end time in the paid response when supplied. Auctions can extend or change schedule.

Show opening bids and high bids as separate values. The API serves snapshots and can return cached results. Treat missing bids and dates as unknown, and confirm current bids, deadlines, deposits, and buyer fees with Auction.com.

Look up one auction listing

Pick a row from your search. Copy its listingId and its matching propertyLink. The detail endpoint can return descriptions, photos, published contact information, and documents in listing.details. Paid plans add available source-specific facts and auction terms.

Shell · listing details

LISTING_ID='REPLACE_WITH_LISTING_ID'
PROPERTY_LINK='REPLACE_WITH_MATCHING_PROPERTY_LINK'

curl --fail-with-body --silent --show-error --max-time 65 \
  --get "https://foreclosure-finder1.p.rapidapi.com/listing/auction/$LISTING_ID" \
  --header "X-RapidAPI-Key: $RAPIDAPI_KEY" \
  --header 'X-RapidAPI-Host: foreclosure-finder1.p.rapidapi.com' \
  --data-urlencode "url=$PROPERTY_LINK"

If the result has no propertyLink, set PROPERTY_LINK to an empty string. url is optional. For a 404, rerun the search and use a current result. Save source and listingId together if your application tracks records across multiple sources.

Use PRO to rank auctions by estimated discount

On PRO, ULTRA, or MEGA, use minDiscount=20 and sort=discount_desc to find auctions with a calculated discount of at least 20% and rank them highest first. BASIC returns 403 for these parameters. Keep the same endpoint and omit both parameters when testing on BASIC.

Shell · paid plans

curl --fail-with-body --silent --show-error --max-time 65 \
  --get 'https://foreclosure-finder1.p.rapidapi.com/zipcode/auction' \
  --header "X-RapidAPI-Key: $RAPIDAPI_KEY" \
  --header 'X-RapidAPI-Host: foreclosure-finder1.p.rapidapi.com' \
  --data-urlencode 'zipcode=30067' \
  --data-urlencode 'radius=25' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'minDiscount=20' \
  --data-urlencode 'sort=discount_desc'

deal.discountToEstimate is (1 − bid ÷ estimate) × 100, rounded to one decimal. For example, a $75,000 bid basis and a $100,000 source estimate produce a 25% discount and a $25,000 deal.spread. Check deal.basis to see whether the API used the current high bid or fell back to the opening bid. The calculation requires a bid basis of at least $1,000 and a positive source estimate.

Use this screen to decide which listings to review. The estimate can change, and the calculation excludes buyer premiums, closing costs, repairs, and financing. Listings without a usable bid or estimate do not match the filter.

Export a shortlist or monitor a market

Start with JSON so you can inspect meta.partial and meta.warnings. SOURCE_FIELDS_UNAVAILABLE means some optional fields were unavailable even though the response contains usable data. If you get zero rows, check the warnings and filters before drawing a conclusion about local auction inventory.

Add format=csv to the search request to open the rows in Excel or Google Sheets. A scheduled script can repeat the search, compare the source and listingId pairs against a saved watchlist, and look up details only for new or relevant results. Every search, page, and detail lookup uses a RapidAPI request.