# Auction Properties List with Email (`kawsar/auction-properties-list-with-email`) Actor Auction properties extractor designed for heavy-hitting cash buyers, house flippers, and wholesale deal-makers looking to instantly spot distressed property liquidations. - **URL**: https://apify.com/kawsar/auction-properties-list-with-email.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 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/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 ## Real Estate Auction Properties List: Find Distressed Deals and Flips Instantly Access an up-to-date, hyper-targeted **auction properties list** with minimal effort. This powerful Apify Actor is built for aggressive real estate investors, cash buyers, hedge funds, and house flippers who need immediate access to distressed assets, county court liquidations, tax lien homes, and bank-owned (REO) auction inventory. In today's highly competitive housing market, standard retail deals on the MLS are heavily saturated with retail homebuyers. Real estate auctions consistently represent the highest-margin, highest-ROI acquisitions available. Stop wasting time manually checking individual county sheriffs' portals or aggressively clicking through fragmented consumer search maps. Our ultra-fast pipeline bridges directly into the backend inventory databases, pulling active properties flagged for auction down into structured JSON, XML, CSV, or Excel formats. ### Why Real Estate Auctions? - **Extreme Discounts**: Bank foreclosures, strategic liquidations, and motivated short sellers offload equity immediately at auction, leaving tens of thousands of dollars in margins for the final winning cash buyer. - **Off-Market Scaling**: Build your next large-scale marketing campaign! Export hundreds of local auction properties instantly and funnel them directly into your real estate CRM or direct mail marketing pipeline. - **No Agent Drama**: You represent yourself as cash. Find the deal, run the cash-on-cash ROI calculations, and bypass traditional bidding wars with direct bids. - **Wholesaling Goldmines**: Many properties flagged for an "Upcoming Auction" are technically still owned by a severely motivated seller. Contact their representation immediately to negotiate a preemptive wholesale equity contract before the gavel even drops! ### Target Personas & Core Use Cases - **House Flippers & Cash Buyers**: Instantly zero in on distressed assets slated for county auction. Calculate rehab costs using precise bed/bath/sqft data and acquire premium under-market flips. - **Real Estate Wholesalers**: Export massive, multi-state auction property lists to build targeted direct-mail outreach campaigns targeting stressed equity owners. - **Hedge Funds & Portfolio Acquisitions**: Automate daily scheduled runs across entire state boundaries (such as all active auctions in Florida or Texas) to feed your algorithmic acquisitions machine. - **Top-Tier Real Estate Brokers**: Track impending real estate liquidations in premium ZIP codes to secure off-market back-end deals for VIP clientele. ### Input Parameters The scraper offers extreme geographic flexibility, allowing you to narrow down to a block or expand across the entire state. | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `postal_code` | string | — | US ZIP code. The most precise analytical location filter. Use this for strict neighborhood targeting. | | `state_code` | string | `FL` | 2-letter US state code. Example: `FL` for Florida, or `TX`. | | `city` | string | — | City name. Highly effective when combined with a state_code. | | `propertyType` | array | — | Narrow by classification. Supported inputs: `single_family`, `condo_townhome`, `multi_family`, `mobile`, `land`, `farm`. | | `beds_min` / `beds_max` | integer | — | Filter target properties based strictly on bedroom count constraints. | | `list_price_min` / `max` | integer | — | Target specific appraisal brackets in USD to align with your hard cash reserves. | | `maxItems` | integer | `5000` | The volume cap on properties to extract per run to control scraping costs. | | `proxyConfiguration` | object | US Datacenter | Proxy routing to prevent bot protection blocks out of the box. Essential for stability. | ### Example Execution Payload This exact JSON payload executes a clean auction search across the State of Florida, zeroing tightly in on single-family homes, and caching up to 1,000 properties rapidly. ```json { "state_code": "FL", "propertyType": ["single_family"], "maxItems": 1000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ```` ### Output Fields Explained Unlike complex and nested raw API data, this Actor intelligently flattens the property data. This immediately exposes the precise coordinates, analytical property metrics, and vital representation contact details without requiring any secondary scripting from your development team! | Extracted Field | Schema Type | Output Description | |-----------------|-------------|--------------------| | `property_id` | string | Permanent tracking ID for avoiding duplicates in your CRM | | `list_price` | integer | The baseline or starting auction bid price in USD | | `is_auction` | boolean | Verified metadata tag (Always guarantees `true` for this extractor) | | `type` / `sub_type` | string | Broad and local property classifications (single\_family, condo, etc.) | | `beds` / `baths_consolidated` | integer | Precise bed and bath counts for ARV (After Repair Value) profiling | | `sqft` / `lot_sqft` | integer | Property footprint interior and exterior dimension metrics | | `year_built` | integer | The construction year indicating age and structural framing standards | | `address_line` / `city` / `state` | string | The complete normalized street addressing block | | `latitude` / `longitude` | number | Exact GPS coordinates. Perfect for importing directly to MapBox or analytical spatial overlays | | `primary_photo_url` | string | Direct HQ CDN link to the featured display image | | `advertiser_1_name` | string | Explicit name of the primary trustee or real estate listing agent overseeing the liquidation | | `advertiser_1_email` | string | Direct representation contact email where available | | `advertiser_1_phones` | array | Telephonic numbers corresponding directly to the representation office | ### Automation and Scheduling **Run Daily Deals Automatically!** The true power of this Apify actor unlocks when you schedule it. By setting up an Apify generic webhook or utilizing the Zapier integration, you can command this actor to scrape your specific county at 7:00 AM every single morning. When a new property unexpectedly enters the auction registry overnight, the actor can immediately push a Slack alert or email notifying you before your competitors finish their morning coffee! #### Dominate your local market. Start building your definitive real estate auction properties list today! # Actor input Schema ## `postal_code` (type: `string`): Filter properties exactly by a 5-digit US ZIP or postal code. This is the most reliable way to target a specific neighborhood. Example: '90210' for Beverly Hills, CA. ## `state_code` (type: `string`): Filter properties broadly by a 2-letter US state code. Best used in combination with other filters. Example: 'CA' for California, 'NY' for New York. ## `city` (type: `string`): Filter properties by the exact city name. Usually best to combine with state\_code. Example: 'Los Angeles' or 'Austin'. ## `street_name` (type: `string`): Target properties located on a specific street name. Example: 'Sunset Blvd' or 'Main St'. ## `address` (type: `string`): Filter for a very specific property address line. Example: '123 Fake Street'. ## `propertyType` (type: `array`): Filter the results by specific property types. Supported options include: apartment, condo\_townhome, condo\_townhome\_rowhome\_coop, condo, condos, single\_family, multi\_family, mobile, land, farm, other. ## `keywords` (type: `array`): Filter properties by specific amenities or descriptive features. Options include: basement, carport, central\_air, den, hardwood\_floors, pool, waterfront, ocean\_view, fireplace. ## `beds_min` (type: `integer`): Minimum threshold for the number of bedrooms. ## `beds_max` (type: `integer`): Maximum threshold for the number of bedrooms. ## `baths_min` (type: `integer`): Minimum threshold for the number of bathrooms (including half-baths). ## `baths_max` (type: `integer`): Maximum threshold for the number of bathrooms. ## `list_price_min` (type: `integer`): Minimum active asking list price in USD. ## `list_price_max` (type: `integer`): Maximum active asking list price in USD. ## `sold_price_min` (type: `integer`): Minimum sold price in USD. ## `sold_price_max` (type: `integer`): Maximum sold price in USD. ## `year_built_min` (type: `integer`): Filter by the year the construction was completed. ## `year_built_max` (type: `integer`): Set a maximum year of completion to target historic or older builds. ## `hoa_fee_max` (type: `integer`): Maximum Homeowners Association monthly fee allowed. ## `limit` (type: `integer`): The number of listings fetched in a single API call. ## `offset` (type: `integer`): The exact positional index the scraper starts at. ## `maxItems` (type: `integer`): The hard cap on total listings the scraper will collect across all paginated API calls. ## `timeoutSecs` (type: `integer`): If the scraper surpasses this runtime duration, it will safely halt and exit. ## `requestTimeoutSecs` (type: `integer`): How long the scraper waits for the server to respond per API query slice. ## `proxyConfiguration` (type: `object`): Select proxies to obscure IP and evade blocking. Note: USA datacenter proxy is set as the default. ## Actor input object example ```json { "postal_code": "90210", "state_code": "FL", "city": "Miami", "propertyType": [ "condo_townhome", "single_family" ], "keywords": [ "basement", "pool" ], "beds_min": 1, "beds_max": 5, "baths_min": 1, "list_price_min": 200000, "list_price_max": 900000, "year_built_min": 2017, "year_built_max": 2023, "limit": 200, "offset": 0, "maxItems": 5000, "timeoutSecs": 300, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ``` # 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 = { "state_code": "FL", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/auction-properties-list-with-email").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 = { "state_code": "FL", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("kawsar/auction-properties-list-with-email").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 '{ "state_code": "FL", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } }' | apify call kawsar/auction-properties-list-with-email --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/auction-properties-list-with-email", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Auction Properties List with Email", "description": "Auction properties extractor designed for heavy-hitting cash buyers, house flippers, and wholesale deal-makers looking to instantly spot distressed property liquidations.", "version": "0.0", "x-build-id": "zerd7Qf5MgmyCMVfx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~auction-properties-list-with-email/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-auction-properties-list-with-email", "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/kawsar~auction-properties-list-with-email/runs": { "post": { "operationId": "runs-sync-kawsar-auction-properties-list-with-email", "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/kawsar~auction-properties-list-with-email/run-sync": { "post": { "operationId": "run-sync-kawsar-auction-properties-list-with-email", "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": { "postal_code": { "title": "Postal code", "type": "string", "description": "Filter properties exactly by a 5-digit US ZIP or postal code. This is the most reliable way to target a specific neighborhood. Example: '90210' for Beverly Hills, CA." }, "state_code": { "title": "State code", "type": "string", "description": "Filter properties broadly by a 2-letter US state code. Best used in combination with other filters. Example: 'CA' for California, 'NY' for New York." }, "city": { "title": "City", "type": "string", "description": "Filter properties by the exact city name. Usually best to combine with state_code. Example: 'Los Angeles' or 'Austin'." }, "street_name": { "title": "Street name", "type": "string", "description": "Target properties located on a specific street name. Example: 'Sunset Blvd' or 'Main St'." }, "address": { "title": "Address", "type": "string", "description": "Filter for a very specific property address line. Example: '123 Fake Street'." }, "propertyType": { "title": "Property type", "type": "array", "description": "Filter the results by specific property types. Supported options include: apartment, condo_townhome, condo_townhome_rowhome_coop, condo, condos, single_family, multi_family, mobile, land, farm, other.", "items": { "type": "string" } }, "keywords": { "title": "Feature keywords", "type": "array", "description": "Filter properties by specific amenities or descriptive features. Options include: basement, carport, central_air, den, hardwood_floors, pool, waterfront, ocean_view, fireplace.", "items": { "type": "string" } }, "beds_min": { "title": "Min bedrooms", "type": "integer", "description": "Minimum threshold for the number of bedrooms." }, "beds_max": { "title": "Max bedrooms", "type": "integer", "description": "Maximum threshold for the number of bedrooms." }, "baths_min": { "title": "Min bathrooms", "type": "integer", "description": "Minimum threshold for the number of bathrooms (including half-baths)." }, "baths_max": { "title": "Max bathrooms", "type": "integer", "description": "Maximum threshold for the number of bathrooms." }, "list_price_min": { "title": "Min list price", "type": "integer", "description": "Minimum active asking list price in USD." }, "list_price_max": { "title": "Max list price", "type": "integer", "description": "Maximum active asking list price in USD." }, "sold_price_min": { "title": "Min sold price", "type": "integer", "description": "Minimum sold price in USD." }, "sold_price_max": { "title": "Max sold price", "type": "integer", "description": "Maximum sold price in USD." }, "year_built_min": { "title": "Year built from", "type": "integer", "description": "Filter by the year the construction was completed." }, "year_built_max": { "title": "Year built to", "type": "integer", "description": "Set a maximum year of completion to target historic or older builds." }, "hoa_fee_max": { "title": "Max HOA fee", "type": "integer", "description": "Maximum Homeowners Association monthly fee allowed." }, "limit": { "title": "Results per pagination page", "minimum": 1, "maximum": 200, "type": "integer", "description": "The number of listings fetched in a single API call.", "default": 200 }, "offset": { "title": "Initial page offset", "minimum": 0, "type": "integer", "description": "The exact positional index the scraper starts at.", "default": 0 }, "maxItems": { "title": "Maximum total results to scrape", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The hard cap on total listings the scraper will collect across all paginated API calls.", "default": 5000 }, "timeoutSecs": { "title": "Overall actor timeout (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "If the scraper surpasses this runtime duration, it will safely halt and exit.", "default": 300 }, "requestTimeoutSecs": { "title": "Per-request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long the scraper waits for the server to respond per API query slice.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to obscure IP and evade blocking. Note: USA datacenter proxy is set as the default." } } }, "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 } } } } } } } } } } ```