# Propwire Property Scraper (`shahidirfan/propwire-property-scraper`) Actor Extract real estate listings from Propwire with property prices, addresses, locations, bedrooms, bathrooms, square footage, property types, and listing URLs. Ideal for real estate investors, property research, market analysis, lead generation, and investment opportunities. - **URL**: https://apify.com/shahidirfan/propwire-property-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## 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 Propwire Property Scraper do? Propwire Property Scraper collects US property records from [Propwire](https://propwire.com) and saves them as a structured dataset. Paste a Propwire search URL, a single property URL, or a location such as a city, ZIP code, county, or state. The Actor returns owner names, mailing addresses, estimated value and equity, mortgage and sale history, MLS details, tax assessments, property characteristics, active lead types, and photo galleries for MLS listings. Use it to build property lists, research off-market opportunities, enrich a CRM, or refresh a real estate dataset without copying records by hand. ### Why use Propwire Property Scraper? - **One record per property** - Get a clean record instead of scattered page content. - **Location or URL input** - Start from a saved search URL, a property details URL, or a plain location. - **Lead, price, and property filters** - Narrow results by lead type, property type, price, bedrooms, bathrooms, year built, and more. - **Scheduled market refreshes** - Run on demand or schedule the Actor to refresh a market on a daily, weekly, or custom interval. - **Export-ready output** - Download the dataset as JSON, CSV, Excel, or XML, or send it to another tool through the Apify API and webhooks. - **No null fields** - Fields without a value are left out of each record instead of saved as null. ### What data can you extract from Propwire? | Field | Description | | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | | `property_id` | Propwire property identifier | | `property_url` | Direct Propwire property details URL | | `address`, `city`, `state`, `zip`, `county` | Property location | | `latitude`, `longitude` | Property coordinates | | `property_type` | Property type such as SFR, condo, or land | | `bedrooms`, `bathrooms` | Bedroom and bathroom counts | | `building_area_sf`, `living_area_sf` | Building and living area in square feet | | `lot_size_sf`, `lot_size_acres` | Lot size | | `stories`, `units`, `year_built` | Structure details | | `estimated_value` | Propwire estimated value | | `estimated_equity`, `estimated_equity_percentage` | Estimated equity amount and share | | `estimated_ltv` | Estimated loan-to-value ratio | | `estimated_price_per_sf`, `estimated_zip_price_per_sf` | Property and ZIP price per square foot | | `last_sold_price`, `last_sold_date` | Most recent recorded sale | | `owner_name` | Recorded owner or owners | | `owner_occupied` | Owner-occupancy indicator | | `owner_mailing_address`, `owner_mailing_city`, `owner_mailing_state`, `owner_mailing_zip` | Owner mailing address | | `years_of_ownership`, `months_of_ownership` | Ownership length | | `company_owned`, `individual_owned`, `government_owned`, `trust_owned`, `investor_owned` | Ownership type flags | | `lead_types` | Active Propwire lead types such as `preforeclosure`, `absentee_owner`, or `high_equity` | | `foreclosure`, `auction_date`, `auction_time` | Foreclosure and auction details | | `days_on_market`, `listing_key` | Listing activity | | `mls_attom_last_status`, `mls_attom_last_status_date`, `mls_attom_price` | Latest MLS status and price | | `mls_list_date`, `mls_list_price`, `mls_list_price_per_sf` | MLS listing details | | `mls_sold_date`, `mls_sold_price`, `mls_sold_price_per_sf` | MLS sold details | | `mls_first_photo_url` | Primary MLS photo as returned by Propwire | | `primary_image_url` | Primary property photo, available for MLS-listed properties | | `image_urls` | Full photo gallery from the MLS media record | | `image_count` | Number of photos in the MLS media record | | `mls_listing_url` | Public listing URL from the MLS media record | | `basement_type`, `basement_sf`, `basement_finished_percentage` | Basement details | | `garage_type`, `garage_area_sf` | Garage details | | `heating_type`, `heating_fuel`, `cooling_type` | Heating and cooling | | `fireplace`, `fireplace_type`, `fireplace_count` | Fireplace details | | `pool`, `pool_type`, `pool_area_sf` | Pool details | | `tax_assessed_year`, `tax_assessed_total`, `tax_assessed_improvements`, `tax_assessed_land` | Tax assessment | | `search_location` | Location or URL used for the run | | `scraped_at` | ISO timestamp for the record | ### Photos and image galleries Property photos come from the MLS media record in the same search response. The Actor does not open individual property pages or make an extra request for images. - `primary_image_url` is the first photo. - `image_urls` is the full gallery. - `image_count` is the number of photos. - `mls_listing_url` points to the public listing when the MLS record provides one. Propwire returns MLS media for active and pending MLS listings. `photosOnly` uses active listings. To collect pending listings with photos, choose `MLS pending` in the Lead type dropdown. Off-market records, and MLS listings with no uploaded media, have no image fields in the search response. ### How to use Propwire Property Scraper 1. Open the Actor in Apify Console. 2. Paste a Propwire search URL, paste a property URL, or leave the URL empty and enter a location. 3. Set filters for price, beds, baths, property type, lead type, owner occupancy, and owner type. Use `photosOnly` when you need listings with photo galleries. 4. Leave the proxy disabled for the default no-proxy run. Enable the Apify residential proxy if Propwire challenges the session. 5. Run the Actor and open the dataset when it finishes. 6. Download the dataset or connect it to Google Sheets, a webhook, or your own system. ### Input Parameters #### Search and limits | Parameter | Type | Required | Default | Description | | -------------------- | ------- | -------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `startUrl` | String | No | - | A Propwire search URL or property details URL. When the URL contains filters or a property ID, it takes priority over `location`. | | `location` | String | No | `Chicago Heights, IL` | City, ZIP code, county, state, or street address. Separate multiple locations with a semicolon. | | `results_wanted` | Integer | No | `20` | Maximum number of properties to save. | | `max_pages` | Integer | No | `10` | Maximum number of result pages to request. Each page can contain up to 250 properties. | | `proxyConfiguration` | Object | No | No proxy | No proxy by default. Enable the Apify residential proxy if Propwire challenges the session. | #### Filters | Parameter | Type | Required | Default | Description | | --------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `priceMin` | Integer | No | - | Minimum Propwire estimated value in USD. | | `priceMax` | Integer | No | - | Maximum Propwire estimated value in USD. | | `bedsMin` | Integer | No | - | Minimum bedrooms. | | `bedsMax` | Integer | No | - | Maximum bedrooms. | | `bathsMin` | Number | No | - | Minimum bathrooms. Decimals are allowed. | | `bathsMax` | Number | No | - | Maximum bathrooms. Decimals are allowed. | | `propertyTypes` | String | No | `any` | Dropdown: Any, Single family, Condo, Mobile, Multi-family (5+), Multi-family (2-4), Land, Commercial, Other. | | `leadTypes` | String | No | `any` | Dropdown: Any, MLS active, MLS pending, MLS sold, Pre-foreclosure, Absentee owner, Out-of-state owner, Cash buyer, High equity, Low equity, Free and clear, Tired landlord, Vacant home, Vacant lot, Zombie property, Bank owned, Auction, Flipped property. | | `photosOnly` | Boolean | No | `false` | Return only active MLS listings, which include photo galleries when the source has them. Overrides `leadTypes`. | | `ownerOccupied` | String | No | `any` | Dropdown: Any, Owner occupied, Not owner occupied. | | `ownerType` | String | No | `any` | Dropdown: Any, Individual, Company, Bank. | The filter fields override the same keys in a `startUrl`. `photosOnly` overrides `leadTypes`. A `startUrl` with filters or a property ID takes priority over `location`. If `startUrl` is a bare Propwire search page, `location` is used. For a filter that is not exposed here, paste a Propwire search URL that already contains it. ### Usage Examples #### Collect properties by location Collect 100 properties from a city: ```json { "location": "Chicago Heights, IL", "results_wanted": 100, "max_pages": 3 } ``` #### Collect from a Propwire search URL Paste a search URL from Propwire and keep its filters: ```json { "startUrl": "https://propwire.com/search?filters=%7B%22locations%22%3A%5B%7B%22searchType%22%3A%22C%22%2C%22city%22%3A%22Chicago%20Heights%22%2C%22state%22%3A%22IL%22%2C%22title%22%3A%22Chicago%20Heights%2C%20IL%22%7D%5D%7D", "results_wanted": 250, "max_pages": 5 } ``` #### Collect one property Paste a property details URL to return that single record: ```json { "startUrl": "https://propwire.com/realestate/548-Minette-Ln-Chicago-Heights-IL/22564/property-details", "results_wanted": 1 } ``` #### Filter by price and beds Find homes between 200,000 and 500,000 with at least three bedrooms: ```json { "location": "Austin, TX", "priceMin": 200000, "priceMax": 500000, "bedsMin": 3, "bathsMin": 2, "results_wanted": 100, "max_pages": 3 } ``` #### Collect MLS listings with photos Return active MLS listings, which include photo galleries: ```json { "location": "Austin, TX", "photosOnly": true, "results_wanted": 50, "max_pages": 2 } ``` #### Filter by property and lead type Find single-family pre-foreclosures: ```json { "location": "Cook, IL", "propertyTypes": "sfr", "leadTypes": "preforeclosure", "results_wanted": 500, "max_pages": 5 } ``` For a filter that is not exposed in the input form, paste a Propwire search URL that already contains it. ### Sample Output ```json { "property_id": 22564, "property_url": "https://propwire.com/realestate/548-Minette-Ln-Chicago-Heights-IL/22564/property-details", "address": "548 Minette Ln", "city": "Chicago Heights", "state": "IL", "zip": "60411", "latitude": 41.500331, "longitude": -87.665423, "property_type": "SFR", "bedrooms": 3, "bathrooms": 1, "building_area_sf": 1093, "living_area_sf": 1093, "lot_size_sf": 8273, "lot_size_acres": 0.19, "stories": 1, "units": 1, "year_built": 1961, "estimated_value": 127106, "estimated_equity": 38680, "estimated_equity_percentage": 30, "estimated_ltv": 0.695685727, "estimated_price_per_sf": 116.29094236, "estimated_zip_price_per_sf": 135.652672226, "last_sold_price": 90000, "last_sold_date": "2019-10-22", "owner_name": "SANCHEZ EDDY", "owner_occupied": true, "owner_mailing_address": "548 MINETTE LN", "owner_mailing_city": "CHICAGO HEIGHTS", "owner_mailing_state": "IL", "owner_mailing_zip": "60411", "months_of_ownership": 141, "years_of_ownership": 12, "individual_owned": true, "lead_types": ["preforeclosure"], "foreclosure": false, "mls_attom_last_status": "CANCELLED", "mls_attom_last_status_date": "2023-01-06", "mls_attom_price": 148000, "mls_attom_price_per_sf": 135.41, "basement_type": "NO BASEMENT", "basement_sf": 0, "garage_type": "Garage, Detached", "garage_area_sf": 0, "heating_type": "Yes", "cooling_type": "Yes", "tax_assessed_year": 2025, "tax_assessed_total": 10179, "tax_assessed_improvements": 7283, "tax_assessed_land": 2896, "search_location": "Chicago Heights, IL", "scraped_at": "2026-10-24T08:30:00.000Z" } ``` #### Sample output with photos Active MLS listings include a photo gallery. Off-market records do not. ```json { "property_id": 26598411, "property_url": "https://propwire.com/realestate/11210-Henge-Dr-Austin-TX/26598411/property-details", "address": "11210 Henge Dr", "city": "Austin", "state": "TX", "zip": "78759", "county": "Travis", "property_type": "SFR", "bedrooms": 3, "bathrooms": 2, "building_area_sf": 1980, "estimated_value": 815000, "estimated_equity": 815000, "owner_name": "210 AUSTIN ANNEX LLC", "lead_types": ["absentee_owner", "cash_buyer", "free_and_clear", "high_equity", "mls_active"], "primary_image_url": "https://lh.rdcpix.com/18e0b5d3b358ed569e12470a0503bfeel-f2978388497r.jpg", "image_urls": [ "https://lh.rdcpix.com/18e0b5d3b358ed569e12470a0503bfeel-f2978388497r.jpg", "https://lh.rdcpix.com/18e0b5d3b358ed569e12470a0503bfeel-f1281653560r.jpg", "https://lh.rdcpix.com/18e0b5d3b358ed569e12470a0503bfeel-f3358773191r.jpg" ], "image_count": 40, "mls_listing_url": "https://www.realtor.com/realestateandhomes-detail/11210-Henge-Dr_Austin_TX_78759_M83400-75625?f=listhub&s=SMABOR&m=623712&c=propwire", "search_location": "Austin, TX", "scraped_at": "2026-10-24T08:30:00.000Z" } ``` ### Tips for Best Results - Use a complete Propwire search URL copied from your browser when you want to reuse filters exactly. - Use a ZIP code, county, or state for broad coverage, and a city for a smaller list. - Start with `results_wanted` at 20 to 100 while testing. Raise it after you confirm the filters. - Each page holds up to 250 properties. Set `max_pages` high enough for the number of results you want. - Use `photosOnly` for active MLS listings with photo galleries. For pending listings, choose `MLS pending` in the Lead type dropdown. Off-market records do not include photos in the search response. - No proxy is the default. If Propwire challenges the session, enable the Apify residential proxy. - Some fields depend on public records and MLS coverage. A missing owner name, mortgage value, or tax value usually means the source did not publish it for that property. - Remove or relax filters if a run returns no results. ### Integrations - **Google Sheets** - Send each run to a spreadsheet for analysis or sharing. - **Webhooks** - Trigger your own service when a run finishes. - **Make or Zapier** - Move new records into a CRM or marketing workflow. - **Apify API** - Start runs and read datasets from your own application. - **CSV, Excel, JSON, XML** - Download the dataset in the format your team already uses. ### Frequently Asked Questions #### Can I export Propwire data to CSV or Excel? Yes. Every Apify dataset can be downloaded as CSV, Excel, JSON, XML, and other supported formats from the Console or through the API. #### Can I collect more than one location in one run? Yes. Separate locations with a semicolon, for example `Chicago Heights, IL; 60411; Cook, IL`. Each location is resolved and added to the same search. #### Can I use a Propwire search URL instead of a location? Yes. Paste a `https://propwire.com/search?filters=...` URL. The Actor reads the filters from the URL and keeps them for the run. #### Can I collect a single property? Yes. Paste a property details URL such as `https://propwire.com/realestate/.../22564/property-details`. The Actor returns that one property. #### How do I get photo galleries? Set `photosOnly` to `true` for active MLS listings, or choose `MLS active` or `MLS pending` in the Lead type dropdown. Propwire returns MLS media for active and pending listings. The photos come from the same search response, so the Actor does not open individual property pages. #### Why are image URLs missing from some records? Off-market records do not include MLS media in Propwire's search response. An MLS listing can also have no uploaded media. `primary_image_url`, `image_urls`, `image_count`, and `mls_listing_url` appear only when the source record has MLS media. #### Why are some fields missing from a record? Propwire builds records from public records and MLS data. If a source does not publish an owner name, tax value, mortgage, or MLS field, that field is omitted instead of saved as null. #### How many properties can one run collect? The Actor requests up to 250 properties per page. `results_wanted` sets the total limit and `max_pages` sets the page cap. Raise both values for larger collections. #### Can I run this Actor on a schedule? Yes. Use Apify Scheduler to run it hourly, daily, weekly, or at a custom interval. Each run creates a new dataset you can compare with earlier runs. #### Does this Actor work for any US state? It works in US markets where Propwire has public property coverage. Coverage and field completeness vary by county and MLS. #### What should I do if a run returns no results? Try a broader location, remove lead-type or price filters, and confirm the Propwire search URL returns results in your browser. If the issue continues, open an issue on the Actor page. #### Is it legal to collect Propwire property data? Propwire publishes property records for public use. You are responsible for complying with applicable laws, Propwire's terms, and privacy rules when you store or contact property owners. ### 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 data. Users are responsible for how they use the data and for complying with applicable laws, website terms, and privacy rules. Property and ownership data can be incomplete, delayed, or inaccurate. Verify important details before making financial or legal decisions. # Actor input Schema ## `startUrl` (type: `string`): Paste a Propwire search URL (https://propwire.com/search?filters=...) or a property URL (https://propwire.com/realestate/.../property-details). When the URL contains search filters or a property ID, it takes priority over Location. ## `location` (type: `string`): City, ZIP code, county, state, or street address. Separate multiple locations with a semicolon. Examples: Chicago Heights, IL; 60411; Cook, IL; Illinois. ## `priceMin` (type: `integer`): Minimum Propwire estimated value. Leave empty for no minimum. ## `priceMax` (type: `integer`): Maximum Propwire estimated value. Leave empty for no maximum. ## `bedsMin` (type: `integer`): Minimum number of bedrooms. ## `bedsMax` (type: `integer`): Maximum number of bedrooms. ## `bathsMin` (type: `number`): Minimum number of bathrooms. Decimals are allowed. ## `bathsMax` (type: `number`): Maximum number of bathrooms. Decimals are allowed. ## `propertyTypes` (type: `string`): Choose one property type, or Any. ## `leadTypes` (type: `string`): Choose one lead type, or Any. Use MLS active for active listings with photo galleries. ## `photosOnly` (type: `boolean`): Return only active MLS listings, which include photo galleries when the source has them. Off-market records do not include photos in Propwire's search response. This overrides Lead type. ## `ownerOccupied` (type: `string`): Filter by owner occupancy. ## `ownerType` (type: `string`): Filter by the recorded owner type. ## `results_wanted` (type: `integer`): The maximum number of properties to save to the dataset. ## `max_pages` (type: `integer`): A safety cap on the number of result pages to request. Each page contains up to 250 properties. ## `proxyConfiguration` (type: `object`): No proxy by default. Enable the Apify residential proxy if Propwire challenges the session. ## Actor input object example ```json { "location": "Chicago Heights, IL", "propertyTypes": "any", "leadTypes": "any", "photosOnly": false, "ownerOccupied": "any", "ownerType": "any", "results_wanted": 20, "max_pages": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 Heights, IL" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/propwire-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 Heights, IL" } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/propwire-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 Heights, IL" }' | apify call shahidirfan/propwire-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,shahidirfan/propwire-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/QRvjep6jNAGFmmeTg/builds/ugbd7efrcqD8FKIzN/openapi.json