Developers & automation builders
Put listings into your app.
Make a first request, check source coverage and connect JSON or CSV to your workflow. Start with 300 free requests per month.
Start the API quickstartFor property developers and investors
A real estate API for US foreclosure auctions and bank-owned listings. Search five sources by ZIP code, city, or address to build a property app or an investor watchlist in Excel or Google Sheets.
BASIC: 300 requests/month at $0. Test coverage before upgrading. PRO: $5/month for 1,000 included requests and richer property data. Extra PRO requests cost $0.10 each. Review plan terms on RapidAPI.
Developers & automation builders
Make a first request, check source coverage and connect JSON or CSV to your workflow. Start with 300 free requests per month.
Start the API quickstartReal estate investors
Test your ZIP code, review the source listings and organize results in a spreadsheet. Start with a guided search on RapidAPI.
Build your first watchlistSaved response from a verified BASIC search. Test a current search for your location on RapidAPI.
200 OK·BASIC plan Saved Nov 8, 2026 at 11:16 p.m. EST · ZIP 30067
All five sources responded. Some optional Auction.com fields were unavailable, and Redfin radius results may omit listings.
Showing 6 of 345 matches. All six returned rows are from Auction.com.The downloads contain the same six listings. Check the original listing for current prices and status.
Marietta, GA 30067 · Cobb County
Opening bid unavailable
2 bd 1.5 ba 1,197 sq ft
Reported start · Sale pending in sampleListing ↗
Stone Mtn, GA 30088 · DeKalb County
$65,000opening bid
3 bd 2.5 ba
Reported start · In progress in sampleListing ↗
Atlanta, GA 30318 · Fulton County
$65,000opening bid
3 bd 2 ba 1,169 sq ft
Reported start · In progress in sampleListing ↗
Atlanta, GA 30354 · Fulton County
$55,000opening bid
4 bd 2 ba 1,419 sq ft
Reported start · In progress in sampleListing ↗
East Point, GA 30344 · Fulton County
$85,000opening bid
4 bd 2 ba 2,000 sq ft
Reported start · In progress in sampleListing ↗
Atlanta, GA 30331 · Fulton County
$150,000opening bid
2 bd 2 ba 1,753 sq ft
Reported start · In progress in sampleListing ↗
How it works
The foreclosure listings API covers Auction.com, HUD HomeStore, Fannie Mae HomePath, Freddie Mac HomeSteps, and Redfin. Each result uses consistent property fields and includes its source, listing ID, and original listing link. Request one source or combine them with /all.
your request→5 sources in parallel→normalize + tier→one JSON response→cached 1 h
Trustee and bank-owned auctions with opening bid, auction dates and status. Every paid plan adds available bidding, valuation and rent estimate data.
/zipcode/auction
HUD-owned home listings with case number, list price and bid deadline where published.
/zipcode/hud
Fannie Mae-owned homes, including available First Look status and property facts from HomePath.
/zipcode/fanniemae
Freddie Mac-owned homes with available list price, property status and First Look information.
/zipcode/freddiemac
Foreclosure and bank-owned listings from Redfin, with photos, property facts and days on market where available.
/zipcode/redfin
| Search by | Auction.com | HUD | Fannie Mae | Freddie Mac | Redfin | All five |
|---|---|---|---|---|---|---|
| ZIP + radius | /zipcode/auction | /zipcode/hud | /zipcode/fanniemae | /zipcode/freddiemac | /zipcode/redfin | /zipcode/all |
| City + state | /city/auction | /city/hud | /city/fanniemae | /city/freddiemac | /city/redfin | /city/all |
| Street address | /nearby/auction | /nearby/hud | /nearby/fanniemae | /nearby/freddiemac | /nearby/redfin | /nearby/all |
| One listing in full | /listing/auction/{id} | /listing/hud/{id} | /listing/fanniemae/{id} | /listing/freddiemac/{id} | Use propertyLink |
Core search fields include address, opening bid or list price, beds, baths, square footage, property type, status, photo and listing link. Detail lookups add descriptions, photos, facts and available source extras.
Search results are fetched from the sources and cached for one hour. Use the original listing link to check current availability and auction terms. Fields may be missing when a source does not publish them.
Filter by price, bedrooms or property type; sort and paginate the results. Paid plans also include Auction.com deal metrics and filters for discount and rental yield estimates.
Integrate
Subscribe on RapidAPI, copy your key, and send it as X-RapidAPI-Key. Your plan sets the data tier automatically; there is nothing else to configure.
curl "https://foreclosure-finder1.p.rapidapi.com/zipcode/all?zipcode=30067&radius=25&limit=6" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: foreclosure-finder1.p.rapidapi.com"
import requests
r = requests.get(
"https://foreclosure-finder1.p.rapidapi.com/zipcode/all",
params={"zipcode": "30067", "radius": 25, "limit": 6},
headers={
"X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY",
"X-RapidAPI-Host": "foreclosure-finder1.p.rapidapi.com",
},
timeout=60,
)
data = r.json()
print(data["meta"]["totalCount"], "listings")
for home in data["listings"][:5]:
print(home["source"], home["address"], home["openingBid"])
// Node 18+ (built-in fetch)
const url = new URL('https://foreclosure-finder1.p.rapidapi.com/zipcode/all')
url.search = new URLSearchParams({ zipcode: '30067', radius: '25', limit: '6' })
const res = await fetch(url, {
headers: {
'X-RapidAPI-Key': 'YOUR_RAPIDAPI_KEY',
'X-RapidAPI-Host': 'foreclosure-finder1.p.rapidapi.com',
},
})
const { meta, listings } = await res.json()
console.log(`${meta.totalCount} listings from ${meta.sources.length} sources`)
for (const home of listings.slice(0, 5)) {
console.log(home.source, home.address, home.openingBid)
}
{
"meta": {
"totalCount": 345,
"returned": 6,
"tier": "free",
"auctionCount": 261,
"hudCount": 7,
"fannieMaeCount": 20,
"freddieMacCount": 16,
"redfinCount": 41,
"partial": true
},
"listings": [
{
"source": "auction",
"listingId": "2224175",
"address": "1805 ASHBOROUGH CIR SE UNIT F, Marietta, GA 30067",
"openingBid": null,
"bedrooms": 2,
"bathrooms": 1.5,
"squareFootage": 1197,
"propertyType": "CONDOMINIUM_UNIT",
"auctionDate": "2026-12-01T15:00:00Z",
"status": "SALE_PENDING",
"assetType": "FORECLOSURE",
"propertyLink": "https://www.auction.com/details/1805-ashborough-cir-se-marietta-ga-2224175"
}
]
}
Every paid plan adds the full available data: coordinates, lotSize and yearBuilt, plus Auction.com bidding, valuation, rentalEstimate and deal fields. Availability depends on the source and listing. See the endpoint documentation on RapidAPI for parameters and response fields.
Set up a RapidAPI key, search a ZIP code and handle the returned data.
See which sources carry REO homes and which fields are available.
Build a spreadsheet export and check pagination, errors and partial results.
Use the foreclosure auction API guide to find auctions by ZIP code, read bid fields, and screen by estimated discount on a paid plan. The Python foreclosure API tutorial shows how to fetch property details and handle incomplete results.
Plans
Every paid plan includes the same full available data. Choose Pro, Ultra or Mega for the monthly request volume you need. RapidAPI handles subscriptions, billing and API keys.
Search your actual ZIP codes and inspect the available fields before paying. CSV exports work on BASIC too.
20 ZIP searches per day use 600 requests in a 30-day month, before extra pages or detail lookups. PRO includes 1,000 requests.
Paid plans add available coordinates, valuations, rent estimates and Auction.com deal metrics. Missing source data stays missing on every plan.
Above 1,050 requests a month, Ultra costs less than Pro. Above 10,200, Mega costs less than Ultra. These comparisons exclude bandwidth charges. Cached responses count toward your request quota. Review current plan terms on RapidAPI before subscribing.
See example inventory before you integrate. Our city pages show listings and source coverage for each market, with links back to the original properties. Inventory varies by location and changes as sources update.
Ask Claude
The API is also published as an MCP server through RapidAPI's endpoint at mcp.rapidapi.com, so Claude, Claude Code and any other MCP client can call it as a tool. Add the server with your RapidAPI key and Claude gets functions like getAllListingsByZipcode, getHudListingsByCity and getAuctionListingsNearby with no glue code. Then you ask a question, Claude runs the right call, and it reasons over the listings that come back.
claude mcp add foreclosure-finder -- npx -y mcp-remote https://mcp.rapidapi.com \
--header "x-api-host: foreclosure-finder1.p.rapidapi.com" \
--header "x-api-key: YOUR_RAPIDAPI_KEY"
# then, inside Claude:
> find HUD homes within 25 miles of downtown Atlanta
FAQ
Search results are fetched from the listing sources and cached for one hour per location and source. The X-Cache response header reports cache use. Source updates may lag real-world changes; confirm prices, availability and auction terms on the original listing.
Search US locations by five-digit ZIP code, city and state, or street address. Inventory and available fields vary by source and market. A search can return no listings, and nearby results may extend beyond the exact ZIP or city. Explore the market directory to see example coverage.
Every paid plan includes the full available data, including Auction.com bidding, valuations, rent estimates and deal metrics when the source supplies them. Pro, Ultra and Mega differ by monthly request allowance. Basic includes core listing data and listing detail lookups.
Every call counts against your RapidAPI quota whether it is a cache hit or miss. Identical concurrent requests share the same source fetch, and successful search results are kept for one hour. Caching reduces repeated source requests and usually makes repeat lookups faster.
Combined searches return results from successful sources and report unavailable sources in meta.failedSources, with reasons in meta.sourceErrors. Check these fields before treating a response as complete. Your integration should also handle HTTP errors and timeouts; you can retry an individual source separately.
Use /listing/{source}/{listingId} with an ID from a search result. Depending on what the source publishes, the detail response can include a description, additional photos, property facts, agent or broker contact information and documents. An unavailable listing can return a 404. This is listing data; it is not a title search or a verification of the property's condition.
No. Your RapidAPI subscription determines the response fields automatically.