# Homefinder Scraper (`getdataforme/homefinder-scraper`) Actor The HomeFinder Scraper is a web crawler that extracts real estate listings from HomeFinder. It collects key details such as price, location, size, bedrooms, bathrooms, and listing status. The scraper handles pagination and dynamic content, providing up-to-date, accurate property insights. - **URL**: https://apify.com/getdataforme/homefinder-scraper.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** Real estate - **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $35.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. 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 ## homefinder_scraper Search and Extract Unlimited HomeFinder Property Listings. **homefinder_scraper** allows you to extract real estate property details, including price, description, amenities, and other important listing information directly from HomeFinder listings. `Note: Please activate Proxy to get the result without blockage.` Running without a proxy may lead to blocked data extraction. ### How the homefinder_scraper works - Rent the **homefinder_scraper** and you will get a **2-hour free trial** to test the actor and check if it meets your needs. - Enter the specific property listing URL in the **"startUrls"** input field. This will allow you to extract data from the property listing of interest. - The scraper extracts detailed property information, such as price, square footage, bedrooms, bathrooms, and more. #### Input Format ```json { "proxyConfiguration": { "useApifyProxy": true }, "startUrls": [ { "url": "https://homefinder.com/property/685993702/4911-Pyrolite-Flats-San-Antonio-TX-78253", "method": "GET" } ] } ```` #### homefinder\_scraper Output Result Sample Once the scraper runs successfully, you will get the following result with the extracted property details: ```json [ { "crawl_date": "2025-02-21 11:13:21", "source_name": "homefinder", "product_url": "https://homefinder.com/property/685993702/4911-Pyrolite-Flats-San-Antonio-TX-78253", "title": "4911 Pyrolite Flats, San Antonio, TX 78253 | HomeFinder | 685993702", "@type": "House", "floorSize": "1650", "numberOfRooms": "undefined", "Price": "$348,500", "bedrooms": "3 Beds", "bathrooms": "2 Baths", "squareFeet": "1,650 sqft", "estimatedMortgage": "$1,833/mo", "description": "The Brown is a single-story, 1651 square foot, 3 bedroom, 2 bathroom, 2-car garage layout. Designed with you and your family in mind, this layout features a separate dining space that leads to an open kitchen. The kitchen includes plenty of cabinet storage, granite countertops, subway tile backsplash, stainless steel appliances, gas cooking range, and deep kitchen island facing the living room. The large first bedroom suite is located off the family room and features double vanity sink, separate tub and walk-in shower, private water closet, and a spacious walk-in closet. Spacious secondary bedrooms with...", "addressLocality": "San Antonio", "addressRegion": "TX", "postalCode": "78253", "streetAddress": "4911 Pyrolite Flats", "latitude": null, "longitude": null, "imageUrl": "https://d26tqmt1mjuqkn.cloudfront.net/_img_/685993702/9022e57a06e3dce9ff20f82cb27ccb1d3d777210/800" } ] ``` #### Output Fields Explanation: - `crawl_date`: Date and time when the property was crawled. - `source_name`: The source of the property data (in this case, "homefinder"). - `product_url`: The URL to the property listing. - `title`: The title of the property listing (typically the address or property ID). - `@type`: The type of dwelling (e.g., "House"). - `floorSize`: Total area of the property in square feet. - `numberOfRooms`: The number of rooms (if available). - `Price`: Listed price of the property. - `bedrooms`: Number of bedrooms in the property. - `bathrooms`: Number of bathrooms in the property. - `squareFeet`: Total square footage of the property. - `estimatedMortgage`: Estimated monthly mortgage payment for the property. - `description`: Description of the property and its features. - `addressLocality`: The city where the property is located. - `addressRegion`: The state where the property is located. - `postalCode`: The zip code of the property. - `streetAddress`: The street address of the property. - `latitude` and `longitude`: The geographic coordinates of the property (if available). - `imageUrl`: URL to the property’s main image. #### Support For more custom outputs or bug reports, please contact us at **support@getdataforme.com** or report an issue. You can easily reach out to us here: [Contact Us](https://getdataforme.com/contact/) Please remember to include an email subject and specific details about your custom support request. Thank you! # Actor input Schema ## `startUrls` (type: `array`): URLs to start with ## `proxyConfiguration` (type: `object`): Specifies proxy servers that will be used by the scraper in order to hide its origin. ## Actor input object example ```json { "startUrls": [ { "url": "https://homefinder.com/property/689286096/552-Kathleen-Pike-San-Antonio-TX-78253" } ], "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "startUrls": [ { "url": "https://homefinder.com/property/689286096/552-Kathleen-Pike-San-Antonio-TX-78253" } ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/homefinder-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 = { "startUrls": [{ "url": "https://homefinder.com/property/689286096/552-Kathleen-Pike-San-Antonio-TX-78253" }], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("getdataforme/homefinder-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 '{ "startUrls": [ { "url": "https://homefinder.com/property/689286096/552-Kathleen-Pike-San-Antonio-TX-78253" } ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call getdataforme/homefinder-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/homefinder-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Homefinder Scraper", "description": "The HomeFinder Scraper is a web crawler that extracts real estate listings from HomeFinder. It collects key details such as price, location, size, bedrooms, bathrooms, and listing status. The scraper handles pagination and dynamic content, providing up-to-date, accurate property insights.", "version": "0.0", "x-build-id": "iphwuAAkAjQ7T4qhe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~homefinder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-homefinder-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/getdataforme~homefinder-scraper/runs": { "post": { "operationId": "runs-sync-getdataforme-homefinder-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/getdataforme~homefinder-scraper/run-sync": { "post": { "operationId": "run-sync-getdataforme-homefinder-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Start estately URLs", "type": "array", "description": "URLs to start with", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```