# Auction.com Scraper — Foreclosures, REO & Auction Listings (`sian.agency/auction-com-property-scraper`) Actor Scrape Auction.com distressed-property listings — foreclosures, bank-owned (REO) and live auctions. Search by location, ZIP, coordinates or URL; pull the auction calendar by state, county and date; get enriched detail (starting bid, deposit, seller terms) and market KPIs. - **URL**: https://apify.com/sian.agency/auction-com-property-scraper.md - **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community) - **Categories:** Automation, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 property extracteds 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Auction.com Scraper — Foreclosures, REO & Live Auction Calendar 🏚️ [![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Store-Zillow Scraper](https://img.shields.io/badge/Store-Zillow%20Scraper-1F4E79)](https://apify.com/sian.agency/zillow-property-scraper?fpr=sian) [![Store-Redfin Scraper](https://img.shields.io/badge/Store-Redfin%20Scraper-A02021)](https://apify.com/sian.agency/redfin-property-scraper?fpr=sian) [![Store-Bayut Scraper](https://img.shields.io/badge/Store-Bayut%20Scraper-93D500)](https://apify.com/sian.agency/bayut-property-scraper?fpr=sian) #### 🎉 The only Auction.com tool that pulls the live foreclosure & REO **auction calendar** — not just listings ##### Get upcoming trustee/courthouse and online REO sale events by state, county & date — plus the full distressed-property market (foreclosures, bank-owned, live auctions) in one run. Built for investors, flippers, wholesalers, and lead-gen teams. --- ### 📋 Overview **Auction.com is the largest US marketplace for distressed real estate** — and this actor turns it into clean, structured data. Search foreclosures and bank-owned (REO) homes anywhere in the US, pull the live auction calendar by state and date, and get enriched listing detail with starting bids, deposits, valuations, and seller terms. **Why investors and lead-gen teams choose us:** - 📅 **The auction calendar nobody else has**: Pull upcoming foreclosure (trustee/courthouse) and bank-owned (online REO) sale events by state, county, and date window — the event timeline that drives the bids. No other Auction.com tool exposes it. - ✅ **Whole-market coverage**: Search by city, county, ZIP, map radius, or a pasted Auction.com URL — nationwide or hyper-local - 🎯 **Distressed-only signal**: Every row carries distress status, asset type, and auction status — no sifting through retail listings - 💰 **Pay only for results**: Generous FREE tier to test, unlimited on PAID — only successful rows are charged - 💎 **Investor-grade detail**: Optional enrichment adds starting bid, deposit, estimated value, foreclosure financials, seller terms, photo galleries, and property specs - ✨ **Market KPIs included**: Every run ships an HTML report with price distribution, asset-type tallies, and location breakdowns > **Independent tool.** This is an independent data-extraction tool and is **not affiliated with, endorsed by, or sponsored by Auction.com, LLC.** "Auction.com" is a trademark of its respective owner and is used here only to describe the public data this tool helps you collect. --- ### ✨ Features - 🧭 **12 operations in one actor** — search (4 modes), property details (2 modes), auction calendar + event lookup, location autocomplete, and helper tools (states, asset-type enums, sell) - 🗺️ **Four search modes** — by location, by ZIP, by coordinates + radius, or by Auction.com URL - 📅 **Auction calendar** — list live and upcoming sale events by state, county, asset type, and date range - 🎫 **Event drill-down** — expand any calendar event to its venue, auctioneer, date/time, and asset count - 🏚️ **Foreclosure & REO split** — filter by `foreclosure` (live trustee/courthouse sales) or `bank-owned` (online REO auctions) - ⭐ **Optional enrichment** — pull the full detail record (photos, starting bid, deposit, valuation, foreclosure financials, seller terms) per listing - ↕️ **Sort & filter** — auction date, newest, price, or distance; toggle `active` vs `removed` inventory - 📊 **HTML market report** — automatic price/asset-type/location analytics saved to the key-value store - 🔢 **Bulk-friendly** — paginate to hundreds of rows per run with a single `maxResults` setting --- ### 🎬 Quick Start Pick an **operation**, give it a target (a location, ZIP, coordinates, or URL), and run. Results land in the Apify dataset as structured rows; an HTML market report is saved to the key-value store. ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~auction-com-property-scraper/runs?token=[YOUR_TOKEN]' \ -H 'Content-Type: application/json' \ -d '{"operation":"searchByLocation","location":"Dallas, TX","maxResults":50}' ```` *** ### 🚀 Getting Started (3 Simple Steps) #### Step 1: Choose your operation Pick `searchByLocation` / `searchByZip` / `searchByCoordinates` / `searchByUrl` for listings, `calendar` for upcoming sale events, or `detailsById` / `detailsByUrl` for a single property. #### Step 2: Set your target Provide the matching field — a `location`, `zipCode`, `latitude`+`longitude`+`radius`, or `url`. For the calendar, set a `state` and an optional `dateFrom`/`dateTo` window. #### Step 3: Run and export Launch the actor. Export results as JSON, CSV, or Excel directly from the dataset. **That's it! In under a minute, you'll have:** - A clean table of distressed listings or auction events - Per-row distress status, auction detail, and valuation - An HTML market report with price and location analytics *** ### 📥 Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | `operation` | string | No | What to pull. One of `searchByLocation`, `searchByZip`, `searchByCoordinates`, `searchByUrl`, `calendar`, `calendarEvent`, `detailsById`, `detailsByUrl`, `autocomplete`, `states`, `enums`, `sell`. Default `searchByLocation`. | | `location` | string | For `searchByLocation` | City, county, or ZIP — e.g. `Dallas, TX`, `Cook County, IL`. Omit for a nationwide sweep. | | `zipCode` | string | For `searchByZip` | A 5-digit US ZIP, e.g. `60628`. | | `latitude` / `longitude` | string | For `searchByCoordinates` | Center point of the search. | | `radius` | string | For `searchByCoordinates` | Search radius in miles around the point. | | `url` | string | For `searchByUrl` / `detailsByUrl` | An Auction.com search or listing URL. | | `listingId` | string | For `detailsById` | The numeric listing id, e.g. `2093283`. | | `state` | string | For `calendar` | 2-letter US state code, e.g. `TX`. | | `dateFrom` / `dateTo` | string | For `calendar` | Date window, `YYYY-MM-DD`. | | `assetType` | string | No | `foreclosure` or `bank-owned` (calendar scoping). | | `eventId` | string | For `calendarEvent` | An event code (`E-31553A`) or venue id. | | `availability` | string | No | `active` (default) or `removed`. | | `sort` | string | No | `auction_date` (default), `newest`, `oldest`, `price_low`, `price_high`, `distance`. | | `enrich` | boolean | No | Fetch full enriched detail per search row (photos, bid, deposit, financials). Default `false`. | | `maxResults` | integer | No | Max rows for paginated operations. FREE tier capped at 60. | **Example — location search with enrichment:** ```json { "operation": "searchByLocation", "location": "Atlanta, GA", "sort": "auction_date", "enrich": true, "maxResults": 100 } ``` **Example — foreclosure auction calendar for a state + date window:** ```json { "operation": "calendar", "state": "TX", "assetType": "foreclosure", "dateFrom": "2026-07-01", "dateTo": "2026-07-31" } ``` *** ### 📤 Output Results are saved to the Apify dataset. Rows share one stream and are tagged by `rowType` — `property` (search listing), `property-detail` (enriched listing), `auction-event` (calendar event), `location-suggestion` (autocomplete), or `reference` (states/enums/sell lookups). | Field | Type | Description | |-------|------|-------------| | `rowType` | string | `property` / `property-detail` / `auction-event` / `location-suggestion` / `reference` | | `listingId` | string | Unique Auction.com listing id | | `url` | string | Full listing URL on auction.com | | `address` | object | Street, city, state, ZIP | | `location` | object | Latitude / longitude | | `distress` | object | Distress status (foreclosure / bank-owned / etc.) | | `auction` | object | Auction status, starting bid, deposit, sale type, dates | | `valuation` | object | Estimated value / list price signals | | `specs` | object | Beds, baths, sqft, lot size, year built, property type | | `media` | object | Photo count + gallery (when enriched) | | `foreclosureFinancials` | object | Opening bid, est. debt, liens (when enriched) | | `sellerTerms` | object | Buyer premium, deposit, financing terms (when enriched) | | `marketingTags` | array | Auction.com badges (e.g. "Bank Owned", "Occupied") | | `eventCode` | string | Calendar-event code (calendar rows) | | `auctioneer` | string | Auctioneer / trustee (calendar rows) | | `venueName` / `venueType` | string | Sale venue + type (calendar rows) | | `date` | string | Auction/event date | | `totalAssets` | number | Assets in the event (calendar rows) | | `scrapedAt` | string | ISO timestamp of extraction | **Example listing row:** ```json { "rowType": "property", "listingId": "2093283", "url": "https://www.auction.com/details/10118-ekukpe-dr-dallas-tx-2093283", "address": { "street": "10118 Ekukpe Dr", "city": "Dallas", "county": "DALLAS", "state": "TX", "zipCode": "75217" }, "location": { "latitude": 32.7451494, "longitude": -96.6495516 }, "distress": { "assetType": "BANK_OWNED", "productType": "REO", "occupancyStatus": "OCCUPIED", "venueType": "ONLINE", "eventCode": "O-1609F" }, "auction": { "status": "SALE_PENDING_CLEARED", "statusLabel": "Jun 14 - Jun 16, 2026" }, "scrapedAt": "2026-06-13T12:55:00.000Z" } ``` *** ### 💼 Use Cases & Examples #### 1. Foreclosure deal sourcing **Investors and flippers hunting below-market distressed homes.** **Input:** `searchByLocation` + `enrich: true` for a target metro. **Output:** Listings with starting bid, deposit, estimated value, and occupancy. **Use:** Build a daily deal pipeline ranked by equity spread. #### 2. Auction calendar monitoring **Wholesalers tracking upcoming trustee and REO sales.** **Input:** `calendar` by `state` with a `dateFrom`/`dateTo` window. **Output:** Event-level rows with date, venue, auctioneer, and asset count. **Use:** Never miss a county foreclosure sale; plan bidding logistics in advance. #### 3. REO portfolio tracking **Asset managers monitoring bank-owned inventory.** **Input:** `calendar` with `assetType: bank-owned` or location search filtered to REO. **Output:** Bank-owned listings and online auction events. **Use:** Track REO velocity and pricing across markets. #### 4. Lead-gen lists for agents & lenders **Lead-gen teams building distressed-homeowner outreach lists.** **Input:** `searchByZip` across target ZIPs. **Output:** Address-level distressed listings with auction timelines. **Use:** Feed CRM campaigns for pre-foreclosure and auction outreach. #### 5. Market analytics & comps **Analysts modeling distressed-market trends.** **Input:** Broad `searchByLocation` with `maxResults: 200`. **Output:** Price distribution, asset-type tallies, and the HTML market report. **Use:** Quantify foreclosure supply and discount depth by region. #### 6. Radius farming around a subject property **Agents and appraisers pulling nearby distressed comps.** **Input:** `searchByCoordinates` with `latitude`, `longitude`, `radius`. **Output:** All distressed listings within the radius. **Use:** Distressed-comp sets for valuations and CMAs. *** ### 🔗 Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/auction-com-property-scraper').call({ operation: 'searchByLocation', location: 'Dallas, TX', maxResults: 50 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/auction-com-property-scraper').call( run_input={'operation': 'calendar', 'state': 'TX', 'assetType': 'foreclosure'} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~auction-com-property-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"operation":"searchByZip","zipCode":"60628","maxResults":50}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule a daily calendar sweep 2. **HTTP Request**: Call the actor API 3. **Process**: Handle JSON results 4. **Action**: Push new auction events to your CRM, sheet, or Slack *** ### 📊 Performance & Pricing #### FREE Tier (Try It Now) - **60 rows** per run — full feature access, same data quality - No credit card required - Perfect for testing a market or a single county #### PAID Tier (Production Ready) - **Unlimited** rows per run - Faster processing, no delays - Pay-per-result: only charged for successful rows 💰 **Best-value distressed-property data on Apify** — pay per result, not per page. 🔗 [View current pricing](https://apify.com/sian.agency/auction-com-property-scraper?fpr=sian) *** ### ❓ Frequently Asked Questions **Q: How many listings can I pull?** A: FREE tier: 60 rows per run. PAID tier: unlimited. **Q: Can I get the upcoming auction calendar, not just listings?** A: Yes — use the `calendar` operation with a `state` and optional date window, then `calendarEvent` to drill into a specific sale. **Q: What's the difference between foreclosure and bank-owned (REO)?** A: `foreclosure` covers live trustee/courthouse sales; `bank-owned` covers online REO auctions. Filter either via `assetType`. **Q: How do I get starting bids, deposits, and financials?** A: Set `enrich: true` on a search, or use `detailsById` / `detailsByUrl` for a single property. **Q: What output formats are available?** A: JSON, CSV, and Excel — export directly from the Apify dataset. **Q: Is this legal?** A: Yes — only publicly available data is extracted. See the legal section below. *** ### 🐛 Troubleshooting **No results returned** - Widen the area (try a county or a larger radius) or check the spelling of `location`. - Confirm the `state` code is the 2-letter form (e.g. `TX`, not `Texas`). **Calendar returns nothing** - Make sure `dateFrom`/`dateTo` bracket a window with scheduled sales, and that `state` is set. **A pasted URL doesn't work** - Use a standard Auction.com search or listing URL; shortened or filtered share-links may not resolve. **Hit the FREE-tier cap** - FREE runs are capped at 60 rows. Upgrade to PAID for unlimited results. *** ### ⚖️ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). *** ### 🤝 Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check [SIÁN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - 📧 *** **Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `operation` (type: `string`): What to pull from Auction.com. **Search (listing rows):** • **searchByLocation** — city / county / ZIP text (omit for nationwide) • **searchByZip** — exact 5-digit ZIP • **searchByCoordinates** — lat/long + radius • **searchByUrl** — paste an auction.com search or property URL **Calendar (auction events):** • **calendar** — upcoming trustee + online REO sales by state/date • **calendarEvent** — one event + all its properties **Detail (single enriched listing):** • **detailsById** / **detailsByUrl** — full financials, terms, photo gallery **Helpers:** • **autocomplete** — resolve a location string • **states / enums / sell** — reference lookups ## `location` (type: `string`): For **searchByLocation** — a city, county or ZIP, e.g. `Dallas, TX`, `Cook County, IL`, `60628`. Leave empty for a nationwide search. ## `zipCode` (type: `string`): For **searchByZip** — a 5-digit US ZIP, e.g. `60628`. ## `latitude` (type: `string`): For **searchByCoordinates** — center latitude, e.g. `32.7767`. ## `longitude` (type: `string`): For **searchByCoordinates** — center longitude, e.g. `-96.797`. ## `radius` (type: `string`): For **searchByCoordinates** — search radius in miles around the point. ## `url` (type: `string`): For **searchByUrl / detailsByUrl** — an auction.com search page (e.g. `https://www.auction.com/residential/tx/`) or a property page (`https://www.auction.com/details/-`). ## `listingId` (type: `string`): For **detailsById** — the numeric id from a listing URL or search card, e.g. `2093283`. ## `state` (type: `string`): For **calendar** — 2-letter US state code to scope the calendar, e.g. `TX`. ## `dateFrom` (type: `string`): For **calendar** — start of the date window, `YYYY-MM-DD`. ## `dateTo` (type: `string`): For **calendar** — end of the date window, `YYYY-MM-DD`. ## `assetType` (type: `string`): For **calendar** — foreclosure (live trustee/courthouse sales) or bank-owned (online REO auctions). Leave empty for any. ## `eventId` (type: `string`): For **calendarEvent** — an event code (`E-31553A`, `R-101`) or numeric venue id from a calendar row. ## `availability` (type: `string`): Search: `active` (live & upcoming, default) or `removed` (closed/sold/pulled). Calendar event: `all`, `available` or `removed`. ## `sort` (type: `string`): Search sort order. ## `enrich` (type: `boolean`): For search operations — fetch the full enriched detail (photo gallery, foreclosure financials, opening bid, deposit and seller terms) for every listing. PAID only; charged per enriched detail. ## `maxResults` (type: `integer`): Maximum rows to collect for paginated operations. FREE tier is capped at 60. ## Actor input object example ```json { "operation": "searchByLocation", "location": "Dallas, TX", "assetType": "", "sort": "auction_date", "enrich": false, "maxResults": 50 } ``` # Actor output Schema ## `results` (type: `string`): Distressed-property listings, auction-calendar events and enriched detail rows (starting bid, estimated value, financials, seller terms). ## `htmlReport` (type: `string`): HTML summary with run stats and market KPIs (median starting bid, estimated-value distribution, asset-type / venue-type / county breakdowns). # 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": "Dallas, TX" }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/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": "Dallas, TX" } # Run the Actor and wait for it to finish run = client.actor("sian.agency/auction-com-property-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": "Dallas, TX" }' | apify call sian.agency/auction-com-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/auction-com-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Auction.com Scraper — Foreclosures, REO & Auction Listings", "description": "Scrape Auction.com distressed-property listings — foreclosures, bank-owned (REO) and live auctions. Search by location, ZIP, coordinates or URL; pull the auction calendar by state, county and date; get enriched detail (starting bid, deposit, seller terms) and market KPIs.", "version": "1.0", "x-build-id": "eSbHtJEoJ7ELRP8ik" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~auction-com-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-auction-com-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sian.agency~auction-com-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-auction-com-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sian.agency~auction-com-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-auction-com-property-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "operation": { "title": "🧭 Operation", "enum": [ "searchByLocation", "searchByZip", "searchByCoordinates", "searchByUrl", "calendar", "calendarEvent", "detailsById", "detailsByUrl", "autocomplete", "states", "enums", "sell" ], "type": "string", "description": "What to pull from Auction.com.\n\n**Search (listing rows):**\n• **searchByLocation** — city / county / ZIP text (omit for nationwide)\n• **searchByZip** — exact 5-digit ZIP\n• **searchByCoordinates** — lat/long + radius\n• **searchByUrl** — paste an auction.com search or property URL\n\n**Calendar (auction events):**\n• **calendar** — upcoming trustee + online REO sales by state/date\n• **calendarEvent** — one event + all its properties\n\n**Detail (single enriched listing):**\n• **detailsById** / **detailsByUrl** — full financials, terms, photo gallery\n\n**Helpers:**\n• **autocomplete** — resolve a location string\n• **states / enums / sell** — reference lookups", "default": "searchByLocation" }, "location": { "title": "📍 Location", "type": "string", "description": "For **searchByLocation** — a city, county or ZIP, e.g. `Dallas, TX`, `Cook County, IL`, `60628`. Leave empty for a nationwide search." }, "zipCode": { "title": "🏷️ ZIP Code", "type": "string", "description": "For **searchByZip** — a 5-digit US ZIP, e.g. `60628`." }, "latitude": { "title": "🌐 Latitude", "type": "string", "description": "For **searchByCoordinates** — center latitude, e.g. `32.7767`." }, "longitude": { "title": "🌐 Longitude", "type": "string", "description": "For **searchByCoordinates** — center longitude, e.g. `-96.797`." }, "radius": { "title": "📏 Radius (miles)", "type": "string", "description": "For **searchByCoordinates** — search radius in miles around the point." }, "url": { "title": "🔗 Auction.com URL", "type": "string", "description": "For **searchByUrl / detailsByUrl** — an auction.com search page (e.g. `https://www.auction.com/residential/tx/`) or a property page (`https://www.auction.com/details/-`)." }, "listingId": { "title": "🆔 Listing ID", "type": "string", "description": "For **detailsById** — the numeric id from a listing URL or search card, e.g. `2093283`." }, "state": { "title": "🗺️ State", "type": "string", "description": "For **calendar** — 2-letter US state code to scope the calendar, e.g. `TX`." }, "dateFrom": { "title": "📅 Date From", "type": "string", "description": "For **calendar** — start of the date window, `YYYY-MM-DD`." }, "dateTo": { "title": "📅 Date To", "type": "string", "description": "For **calendar** — end of the date window, `YYYY-MM-DD`." }, "assetType": { "title": "🏚️ Asset Type", "enum": [ "", "foreclosure", "bank-owned" ], "type": "string", "description": "For **calendar** — foreclosure (live trustee/courthouse sales) or bank-owned (online REO auctions). Leave empty for any.", "default": "" }, "eventId": { "title": "🎫 Event ID", "type": "string", "description": "For **calendarEvent** — an event code (`E-31553A`, `R-101`) or numeric venue id from a calendar row." }, "availability": { "title": "📦 Availability", "type": "string", "description": "Search: `active` (live & upcoming, default) or `removed` (closed/sold/pulled). Calendar event: `all`, `available` or `removed`." }, "sort": { "title": "↕️ Sort", "enum": [ "auction_date", "newest", "oldest", "price_low", "price_high", "distance" ], "type": "string", "description": "Search sort order.", "default": "auction_date" }, "enrich": { "title": "⭐ Enrich search results", "type": "boolean", "description": "For search operations — fetch the full enriched detail (photo gallery, foreclosure financials, opening bid, deposit and seller terms) for every listing. PAID only; charged per enriched detail.", "default": false }, "maxResults": { "title": "🔢 Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum rows to collect for paginated operations. FREE tier is capped at 60.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```