# Home Prices & Listings Scraper: Redfin Homes by Area (`scrapemint/home-listings-scraper`) Actor Get every home for sale in any US area from Redfin. Paste a Redfin link or a zip code: price, beds, baths, size, price per square foot, HOA fee, days on market, year built, GPS location and listing link for every home. Filter by price, beds and home type. No API key needed. - **URL**: https://apify.com/scrapemint/home-listings-scraper.md - **Developed by:** [Ken M](https://apify.com/scrapemint) (community) - **Categories:** Real estate, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Home Prices & Listings Scraper: Redfin Homes by Area Get every home for sale in any US area. Paste the Redfin link for a city, zip code, neighborhood or county (or just a 5 digit zip code) and get one clean row per home. Built for **real estate investors, agents, analysts and anyone researching a market**. Checking listings one by one takes hours; this pulls a whole area in one run, ready for a spreadsheet. ### What you get for each home - **Price**, and price per square foot - **Beds, baths, size, lot size, year built** - **HOA fee per month** where there is one - **Days on market**, and the date the home last changed hands - **New construction flag** - **Exact GPS location** (latitude, longitude) for maps - **MLS number and the listing link** ### How to point it at an area 1. Go to redfin.com, search your area, copy the page link, e.g. `https://www.redfin.com/city/30818/TX/Austin`. City, zip, neighborhood and county pages all work. 2. Or skip that and just enter a 5 digit zip code like `78701`. Filters: min and max price, min bedrooms, home type (house, condo, townhouse, multi family, land). ### Example output ```json { "area": "https://www.redfin.com/city/30818/TX/Austin", "address": "3501 Mt Bonnell Rd", "city": "Austin", "state": "TX", "zip": "78731", "price": 9925000, "beds": 5, "baths": 5.5, "squareFeet": 6100, "pricePerSquareFoot": 1627, "yearBuilt": 2016, "hoaPerMonth": null, "daysOnMarket": 12, "latitude": 30.32, "longitude": -97.77, "mlsNumber": "5061725", "url": "https://www.redfin.com/TX/Austin/3501-Mt-Bonnell-Rd-78731/home/31558906" } ```` ### Pricing **$0.005 per home.** The **first 2 rows of every run are free**. A full city run (up to 350 homes per area) costs at most $1.75; a zip code run usually costs cents. Compare that with paid MLS data feeds that start at hundreds of dollars per month. ### How to run it via API ```bash curl -X POST "https://api.apify.com/v2/acts/scrapemint~home-listings-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"areas": ["78701"], "maxPrice": 800000, "minBeds": 2}' ``` ### Frequently asked questions **How many homes per area?** Up to 350 per area per run (the source caps it). Add more zip codes to cover a big city fully; zips are the sharpest tool. **Sold homes and rentals?** Not in this version, for sale listings only. Each row does include the date the home last changed hands where known. ### More tools from Scrapemint - [Website Change Monitor](https://apify.com/scrapemint/website-change-monitor): watch any listing page for changes. - [Building Permit Leads](https://apify.com/scrapemint/building-permit-leads): fresh building permits from city portals. - [New Business Registration Leads](https://apify.com/scrapemint/new-business-registration-leads): newly registered companies by state. # Actor input Schema ## `areas` (type: `array`): One per line. Paste the Redfin page link for a city, zip code, neighborhood or county (e.g. https://www.redfin.com/city/30818/TX/Austin), or just a 5 digit US zip code (e.g. 78701). ## `minPrice` (type: `integer`): Skip homes cheaper than this. Empty = no minimum. ## `maxPrice` (type: `integer`): Skip homes more expensive than this. Empty = no maximum. ## `minBeds` (type: `integer`): Skip homes with fewer bedrooms. Empty = any. ## `propertyTypes` (type: `array`): Which kinds of homes to include. Empty = houses, condos, townhouses and multi family. ## `maxRows` (type: `integer`): Cap on homes returned (up to 350 per area). Controls total cost. First 2 rows per run are free. ## Actor input object example ```json { "areas": [ "https://www.redfin.com/city/30818/TX/Austin" ], "propertyTypes": [ "house", "condo", "townhouse" ], "maxRows": 100 } ``` # 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 = { "areas": [ "https://www.redfin.com/city/30818/TX/Austin" ], "propertyTypes": [ "house", "condo", "townhouse" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapemint/home-listings-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 = { "areas": ["https://www.redfin.com/city/30818/TX/Austin"], "propertyTypes": [ "house", "condo", "townhouse", ], } # Run the Actor and wait for it to finish run = client.actor("scrapemint/home-listings-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 '{ "areas": [ "https://www.redfin.com/city/30818/TX/Austin" ], "propertyTypes": [ "house", "condo", "townhouse" ] }' | apify call scrapemint/home-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapemint/home-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Home Prices & Listings Scraper: Redfin Homes by Area", "description": "Get every home for sale in any US area from Redfin. Paste a Redfin link or a zip code: price, beds, baths, size, price per square foot, HOA fee, days on market, year built, GPS location and listing link for every home. Filter by price, beds and home type. No API key needed.", "version": "0.1", "x-build-id": "xD6Kzrh67Zpwtg3O8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~home-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-home-listings-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/scrapemint~home-listings-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-home-listings-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/scrapemint~home-listings-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-home-listings-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": { "areas": { "title": "Areas (Redfin links or zip codes)", "type": "array", "description": "One per line. Paste the Redfin page link for a city, zip code, neighborhood or county (e.g. https://www.redfin.com/city/30818/TX/Austin), or just a 5 digit US zip code (e.g. 78701).", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Min price ($)", "minimum": 0, "type": "integer", "description": "Skip homes cheaper than this. Empty = no minimum." }, "maxPrice": { "title": "Max price ($)", "minimum": 0, "type": "integer", "description": "Skip homes more expensive than this. Empty = no maximum." }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Skip homes with fewer bedrooms. Empty = any." }, "propertyTypes": { "title": "Home types", "type": "array", "description": "Which kinds of homes to include. Empty = houses, condos, townhouses and multi family.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multi_family", "land", "other" ], "enumTitles": [ "House", "Condo", "Townhouse", "Multi family", "Land", "Other" ] }, "default": [ "house", "condo", "townhouse", "multi_family" ] }, "maxRows": { "title": "Max rows per run", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Cap on homes returned (up to 350 per area). Controls total cost. First 2 rows per run are free.", "default": 100 } } }, "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 } } } } } } } } } } ```