# Auction.com Property Scraper (`shahidirfan/auction-com-property-scraper`) Actor Discover real estate investment opportunities with Auction.com Property Scraper. Extract foreclosure listings, REO properties, auction prices, bidding details, property addresses, and auction dates. Find potential deals, track property auctions, and analyze investment markets. - **URL**: https://apify.com/shahidirfan/auction-com-property-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.80 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What does Auction.com Property Scraper do? Auction.com Property Scraper collects public property auction listings from Auction.com and saves them as a clean dataset. Paste an Auction.com search URL or enter a location, and the Actor returns addresses, property details, estimated values, opening bids, auction dates and seller tags. The Actor suits investors, analysts and data teams that track foreclosure and bank-owned inventory. Filter by property type, sale format, asset category, bedrooms, bathrooms and living area, then export the results to CSV, Excel, JSON or your own application. ### Why use Auction.com Property Scraper? - Turn city, county, state or ZIP searches into one dataset you can sort and compare. - Capture opening bids, auction start and end times, reserve status and bidding style next to the property details. - Schedule repeat runs to refresh a market daily or weekly and compare new listings with earlier runs. - Use a full search URL for an exact filter combination, or use location plus filters and let the Actor resolve the market. - Receive only the values the source returned. The Actor omits empty fields instead of writing nulls. ### What data can you extract from Auction.com? | Field | Description | | ----------------------- | ---------------------------------------------------- | | `listing_id` | Auction.com listing identifier | | `listing_url` | Property detail page | | `address_line1` | Street address | | `address_line2` | City, state, ZIP and county | | `city` | Property city | | `state` | Two-letter state code | | `county` | Property county | | `zip_code` | Postal code | | `property_type` | Single family, multi-family, condo or land | | `bedrooms` | Bedroom count | | `bathrooms` | Bathroom count, including half baths | | `square_footage` | Living area in square feet | | `lot_size_acres` | Lot size in acres | | `year_built` | Construction year | | `estimated_value` | Estimated market value in USD | | `starting_bid` | Opening bid in USD | | `current_highest_bid` | Highest bid while bidding is open | | `bid_count` | Number of bids placed | | `auction_start_date` | Auction start timestamp | | `auction_end_date` | Auction end timestamp | | `auction_type` | Bidding style such as English or sealed bid | | `sale_method` | Online or live auction segment | | `asset_type` | Bank owned, foreclosure, private seller and similar | | `occupancy_status` | Occupancy reported by the seller | | `reserve_status` | Whether the reserve has been met | | `estimated_rent` | Estimated monthly rent in USD | | `tags` | Listing badges such as interior access or first look | | `open_houses` | Scheduled inspection times | | `photos` | Every property photo URL | | `photos_count` | Number of photos published for the listing | | `latitude`, `longitude` | Property coordinates | | `scraped_at` | Collection timestamp | ### How to use Auction.com Property Scraper 1. Open the Actor in Apify Console. 2. Paste an Auction.com search URL, or leave the URL empty and enter a location. 3. Choose property types, sale formats and asset categories. 4. Set the maximum number of listings and result pages. 5. Run the Actor and open the dataset to review or export the results. When a search URL is provided, it takes priority over the location and filter fields. Clear the URL to use the form-based filters. ### Input Parameters | Parameter | Type | Required | Default | Description | | -------------------- | ------- | -------- | -------------------- | -------------------------------------------------------------------------------- | | `startUrl` | String | No | - | Full Auction.com search results URL; overrides location and filters | | `location` | String | No | `Chicago, IL` | City, county, state or ZIP code | | `propertyTypes` | Array | No | All types | Single family, multi-family, condos and townhouses, land | | `auctionTypes` | Array | No | All formats | Online, in person, remote bid, direct offer | | `assetTypes` | Array | No | All categories | Bank owned, foreclosures, newly foreclosed, short sales, private seller, rentals | | `bedsMin` | Integer | No | - | Minimum bedroom count | | `bathsMin` | Number | No | - | Minimum bathroom count; fractions allowed | | `minSqft` | Integer | No | - | Minimum living area in square feet | | `radiusMiles` | Integer | No | `50` | Distance around a resolved city, ZIP or address | | `sortBy` | String | No | `auction_date_order` | Result order such as auction date, price estimate or distance | | `results_wanted` | Integer | No | `20` | Maximum number of listings to save | | `max_pages` | Integer | No | `5` | Maximum number of result pages to request | | `proxyConfiguration` | Object | No | Apify Proxy | Proxy settings; use a US IP | ### Output Data | Field | Type | Description | | -------------------- | ------- | ---------------------------- | | `listing_id` | String | Unique listing identifier | | `listing_url` | String | Link to the property page | | `address_line1` | String | Street address | | `address_line2` | String | City, state, ZIP and county | | `property_type` | String | Property category | | `bedrooms` | Integer | Bedroom count | | `bathrooms` | Number | Bathroom count | | `square_footage` | Integer | Living area | | `estimated_value` | Integer | Estimated value in USD | | `starting_bid` | Integer | Opening bid in USD | | `auction_start_date` | String | Auction start | | `auction_end_date` | String | Auction end | | `asset_type` | String | Asset category | | `tags` | Array | Listing badges | | `primary_photo` | String | Main property photo | | `photos` | Array | All property photo URLs | | `photos_count` | Integer | Number of photos published | | `scraped_at` | String | ISO timestamp for collection | ### Usage Examples #### Collect from a search URL Use a complete search URL when you already know the filters you want: ```json { "startUrl": "https://www.auction.com/residential/IL/Chicago_ct/active_lt/online,in_person,remote_bid,offer_af/single-family,multi-family,condos-townhouses,land_pt/4_bd/1_bt/500_any_sqft/auction_date_order,resi_sort_v2_st/y_nbs/bank-owned,foreclosures,private-seller,newly-foreclosed_at", "results_wanted": 50, "max_pages": 3 } ``` #### Search a city with filters Resolve the location and narrow the results by property type, asset category and size: ```json { "location": "Miami, FL", "propertyTypes": ["single-family", "multi-family"], "assetTypes": ["bank-owned", "foreclosures"], "bedsMin": 3, "minSqft": 1200, "radiusMiles": 25, "results_wanted": 100 } ``` #### Monitor a whole state Collect active listings across a state and sort by auction date: ```json { "location": "Texas", "propertyTypes": ["single-family", "land"], "sortBy": "auction_date_order", "results_wanted": 200, "max_pages": 5 } ``` ### Sample Output ```json { "listing_id": "2219657", "property_id": "1164292", "listing_url": "https://www.auction.com/details/3249-w-61st-pl-chicago-il-2219657", "listing_status": "SALE_PENDING_CLEARED", "listing_status_group": "ACTIVE", "auction_date_label": "Oct 24", "address_line1": "3249 W 61st PL", "address_line2": "Chicago, IL 60629, Cook County", "city": "Chicago", "state": "IL", "county": "Cook", "zip_code": "60629", "latitude": 41.7814922, "longitude": -87.7050967, "property_type": "SINGLE_FAMILY", "bedrooms": 4, "bathrooms": 2, "square_footage": 1413, "lot_size_acres": 0.09, "year_built": 1900, "estimated_value": 279773, "starting_bid": 95000, "auction_start_date": "2026-10-24T12:00:00Z", "auction_end_date": "2026-10-26T16:01:10Z", "auction_type": "ENGLISH", "sale_method": "OnlineAuctionSegment", "asset_type": "BANK_OWNED", "occupancy_status": "VACANT", "reserve_status": "RESERVE_NOT_MET", "estimated_rent": 2366, "estimated_rent_low": 1916, "estimated_rent_high": 2816, "tags": ["VACA", "INTP"], "primary_photo": "https://adc-tenbox-prod.imgix.net/resi/propertyImages/1164292/1164292_extf_1.v4.jpeg?auto=compress,format", "photos": [ "https://adc-tenbox-prod.imgix.net/resi/propertyImages/1164292/1164292_extf_1.v4.jpeg?auto=compress,format", "https://adc-tenbox-prod.imgix.net/resi/propertyImages/1164292/1164292_extb_6.v3.jpeg?auto=compress,format", "https://adc-tenbox-prod.imgix.net/resi/propertyImages/1164292/1164292_2.v2.jpeg?auto=compress,format", "https://adc-tenbox-prod.imgix.net/resi/propertyImages/1164292/1164292_3.v1.jpeg?auto=compress,format" ], "photos_count": 74, "scraped_at": "2026-10-24T09:27:29.133Z" } ``` ### Tips for Best Results - Use a US proxy. Auction.com blocks many non-US addresses. - Start with 20 to 50 listings to confirm the filters, then raise `results_wanted` for the full market. - Set `max_pages` above one when you request more than 500 listings. - Use the full search URL when you need exact filter combinations that the form does not expose. - Expect some fields to be missing when the seller withholds that data, such as occupancy or valuation. - Schedule repeat runs to track new listings and auction changes over time. ### Integrations - **Google Sheets** - Export results for sorting and sharing. - **Webhooks** - Send each finished run to your own service. - **Make or Zapier** - Add listings to a CRM, database or alerting flow. - **API** - Read the dataset from your own applications. - **CSV and Excel** - Download the dataset for offline analysis. ### Frequently Asked Questions #### Can I export Auction.com listings to CSV or Excel? Yes. Open the dataset in Apify Console and download it as CSV, Excel, JSON or XML. #### Can I scrape Auction.com by city, county or ZIP? Yes. Enter a city such as Chicago, IL, a county such as Cook County, IL, a state such as Texas, or a five digit ZIP code. #### How many listings can one run collect? Each request returns up to 500 listings. Set `results_wanted` and `max_pages` to control the total and the number of requests. #### Why are some fields missing from a record? The Actor removes empty values on purpose. If the seller does not publish a valuation, occupancy status or auction end date, that key is absent from the record. #### Can I run this Actor on a schedule? Yes. Create a schedule in Apify Console to run hourly, daily or weekly, then compare datasets over time. #### Do I need a proxy? Use a US proxy. Without one, Auction.com may return a blocked page or no data. #### Can I get all property photos? Yes. Each record includes `photos`, a list of every published photo URL for the property, plus `photos_count` and `primary_photo`. Listings with no published photos omit the `photos` key. #### Can I use an Auction.com detail page URL? Use search results URLs. Detail page URLs are not search pages and do not carry the filter information the Actor needs. #### Is it legal to collect Auction.com listings? The Actor collects publicly available auction listings. You are responsible for complying with applicable laws, website terms and privacy rules. ### Related Actors - [Propertyfinder Scraper](https://apify.com/shahidirfan/Propertyfinder-Scraper) - Property listings from Property Finder. - [Domain.com.au Property Scraper](https://apify.com/shahidirfan/Domain-com-au-Property-Scraper) - Australian property listings and prices. - [Realtor.ca Property Scraper](https://apify.com/shahidirfan/realtor-ca-property-scraper) - Canadian property listings. - [Rent.com Scraper](https://apify.com/shahidirfan/rent-com-scraper) - Rental listings for market comparison. ### Support For issues, feature requests or custom Actor work, use the Issues tab on the Actor page or contact the developer through Apify. ### Legal Notice This Actor is designed for legitimate collection of publicly available property auction data. Users are responsible for using the data responsibly and complying with applicable laws and website terms. # Actor input Schema ## `startUrl` (type: `string`): An Auction.com search results URL. When set, it takes priority over Location and the filter fields. ## `location` (type: `string`): City, county, state or ZIP code, for example Chicago, IL or 90210. Used when Search URL is empty. ## `propertyTypes` (type: `array`): Property types to include. Leave all selected to search every type. ## `auctionTypes` (type: `array`): Sale formats to include. Leave all selected to search every format. ## `assetTypes` (type: `array`): Asset categories to include. Leave empty to search every category. ## `bedsMin` (type: `integer`): Lowest bedroom count to include. ## `bathsMin` (type: `number`): Lowest bathroom count to include. Fractions such as 1.5 are allowed. ## `minSqft` (type: `integer`): Smallest living area to include, in square feet. ## `radiusMiles` (type: `integer`): How far around the resolved city, ZIP or address to search when using Location. ## `sortBy` (type: `string`): Order of listings returned by the search. ## `results_wanted` (type: `integer`): The maximum number of listings to save. ## `max_pages` (type: `integer`): A safety cap on how many result pages to request. ## `proxyConfiguration` (type: `object`): Auction.com blocks many non-US addresses. Use a US proxy such as Apify Proxy. ## Actor input object example ```json { "location": "Chicago, IL", "propertyTypes": [ "single-family", "multi-family", "condos-townhouses", "land" ], "auctionTypes": [ "online", "in_person", "remote_bid", "offer" ], "assetTypes": [], "radiusMiles": 50, "sortBy": "auction_date_order", "results_wanted": 20, "max_pages": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "Chicago, IL" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/auction-com-property-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "Chicago, IL" } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/auction-com-property-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": "Chicago, IL" }' | apify call shahidirfan/auction-com-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,shahidirfan/auction-com-property-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/K8PWQZDgD2fnV9XiN/builds/5HuCplaPj5UoNcPZq/openapi.json