# FurnishedFinder Rental Extractor (`kawsar/furnishedfinder-rental-extractor`) Actor FurnishedFinder rental extractor that pulls listings by city and move-in date, so you get price, availability, bedrooms, and amenities in one automated run. - **URL**: https://apify.com/kawsar/furnishedfinder-rental-extractor.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** Automation, Real estate, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $3.99 / 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 ## FurnishedFinder Rental Extractor Extract furnished rental listings from [FurnishedFinder.com](https://www.furnishedfinder.com) at scale. Search any US city or zip code, filter by move-in date, move-out date, and monthly budget, and get back a clean structured dataset with prices, bedrooms, bathrooms, amenities, photos, and availability — ready for spreadsheets, dashboards, or any downstream tool. No browser. No manual copy-paste. Run once or put it on a schedule. ### What you get Each listing in the results includes: - Property title, type (House / Apartment / Room / Condo / Studio), and direct URL - Monthly rent in USD (as a plain integer — easy to sort and filter) - Bedrooms and bathrooms count - City and state where the listing is located - Availability status (available or not) - Amenities listed on the card: WiFi, Utilities Included, Washer and dryer, Parking, Pet Friendly, Pool, and more - Primary listing photo URL - Which search location or zip code produced this result ### Use cases - **Corporate relocation** — compare furnished inventory and pricing across multiple cities before deciding where to place employees - **Travel nurse housing** — pull available listings near specific hospitals by city or zip code, filtered to your move-in window - **Market research** — track how furnished rental prices and availability shift week over week by scheduling regular runs - **Property investment** — benchmark competitor pricing in markets you are evaluating - **Aggregation** — build a multi-city furnished rental feed for a dashboard, internal tool, or client report --- ### Input #### Search section At least one **Location** or **Zip code** is required. You can combine both in a single run. ##### Locations Enter one city per line. The actor accepts several formats: | Format | Example | |--------|---------| | City, State | `New York, NY` | | City, State, Zip | `Austin, TX 78701` | | Full street address | `456 Oak Ave, Seattle, WA 98101` | The state must be the two-letter US abbreviation (NY, CA, TX, FL, IL, etc.). **Common city examples:** ```` New York, NY Los Angeles, CA Chicago, IL Houston, TX Miami, FL Dallas, TX Phoenix, AZ San Antonio, TX San Diego, CA Denver, CO Seattle, WA Boston, MA Atlanta, GA Las Vegas, NV Nashville, TN ``` ##### Zip codes Enter one US zip code per line. The actor looks up the city and state automatically. ``` 10001 (New York, NY) 90210 (Beverly Hills, CA) 60601 (Chicago, IL) 77001 (Houston, TX) 33101 (Miami, FL) 78701 (Austin, TX) ```` --- #### Filters section All filters apply to every location in the search list. ##### Move-in date The earliest acceptable move-in date. Listings are filtered to those available on or after this date. Accepted date formats — the actor converts any of these automatically: | Format | Example | |--------|---------| | YYYY-MM-DD *(recommended)* | `2026-06-01` | | DD-MM-YYYY | `01-06-2026` | | DD/MM/YYYY | `01/06/2026` | | MM/DD/YYYY | `06/01/2026` | ##### Move-out date The latest acceptable end-of-stay date. Use together with Move-in date to target listings available for a specific rental window. ##### Min monthly budget (USD) Skip listings priced **below** this amount per month. Leave blank for no minimum. Most furnished rentals in major US cities fall in the $1,500–$8,000/month range. Setting this too low (under $500) in cities like New York or San Francisco will return 0 results because no real listings exist at that price. ##### Max monthly budget (USD) Skip listings priced **above** this amount per month. Leave blank for no maximum. **Budget range reference by market:** | Market | Typical range | |--------|--------------| | New York, NY | $2,000 – $10,000+ | | Los Angeles, CA | $1,800 – $8,000 | | Miami, FL | $1,500 – $6,000 | | Chicago, IL | $1,200 – $5,000 | | Houston, TX | $1,000 – $4,000 | | Denver, CO | $1,200 – $4,500 | | Nashville, TN | $1,000 – $3,500 | --- #### Limits section ##### Max items per location How many listings to collect **per location or zip code**. If you search 3 cities at 50 items each, you get up to 150 results total. - Default: `30` - Maximum: `1000` The actor pages through search results automatically — no need to set a page count. It stops when it hits your item limit or when the site returns no more listings. --- ### Example inputs #### Single city, date window, budget cap ```json { "locations": ["New York, NY"], "moveInDate": "2026-06-01", "moveOutDate": "2026-09-01", "minBudget": 2000, "maxBudget": 5000, "maxItems": 50 } ```` #### Multiple cities, no date filter ```json { "locations": [ "New York, NY", "Los Angeles, CA", "Miami, FL", "Chicago, IL" ], "maxItems": 30 } ``` #### Search by zip codes only ```json { "zipCodes": ["10001", "10002", "10003", "10004"], "moveInDate": "2026-07-01", "maxBudget": 4000, "maxItems": 50 } ``` #### Mix of cities and zip codes ```json { "locations": ["Chicago, IL", "Miami, FL"], "zipCodes": ["90210", "78701"], "moveInDate": "2026-08-01", "moveOutDate": "2026-12-01", "minBudget": 1500, "maxBudget": 6000, "maxItems": 40 } ``` *** ### Output Results are saved to the Apify dataset. Each record is one property listing. ```json { "propertyId": "994889_1", "propertyUrl": "https://www.furnishedfinder.com/property/994889_1", "imageUrl": "https://www.furnishedfinder.com/_pserp_/994889/1/994889_1_63318481-full.JPG", "listingTitle": "Sunny Stylish 3BR in Crown Heights Near Transit", "propertyType": "House", "location": "Brooklyn, NY", "pricePerMonth": 6250, "bedrooms": 3, "bathrooms": 1, "isAvailable": true, "amenities": ["Utilities Included", "WiFi", "Washer and dryer"], "searchRank": 1, "locationSearched": "New York, NY", "scrapedAt": "2026-05-20T14:32:11.042Z" } ``` #### Output field reference | Field | Type | Description | |-------|------|-------------| | `propertyId` | string | Unique property ID on FurnishedFinder (e.g. `994889_1`) | | `propertyUrl` | string | Direct link to the full listing page | | `imageUrl` | string | Primary listing photo URL | | `listingTitle` | string | Property headline as shown in search results | | `propertyType` | string | `House`, `Apartment`, `Room`, `Condo`, or `Studio` | | `location` | string | City and state from the listing card (e.g. `Brooklyn, NY`) | | `pricePerMonth` | integer | Monthly rent in USD, as a plain number (no `$` or commas) | | `bedrooms` | integer | Number of bedrooms | | `bathrooms` | integer | Number of bathrooms | | `isAvailable` | boolean | `true` if the listing shows as available, `false` otherwise | | `amenities` | array | Amenity tags shown on the card | | `searchRank` | integer | Position in search results for this location (1-indexed) | | `locationSearched` | string | The city or zip code input that returned this listing | | `scrapedAt` | string | UTC timestamp when this record was collected | #### Amenity values The `amenities` array can contain any combination of: `WiFi` · `Utilities Included` · `Washer and dryer` · `Parking` · `Pet Friendly` · `Pool` · `Air conditioning` · `Gym` · `Dishwasher` · `Cable TV` *** ### How it works 1. **Location resolution** — each city input is parsed to a FurnishedFinder URL slug. Zip codes are looked up to find the matching city and state first. 2. **Date normalisation** — move-in and move-out dates are accepted in any common format (YYYY-MM-DD, DD-MM-YYYY, DD/MM/YYYY) and converted automatically. 3. **Search page fetch** — the actor retrieves each results page and parses listing cards from the HTML. 4. **Budget filtering** — listings outside your min/max budget range are skipped before saving. 5. **Pagination** — the actor pages through results automatically, up to 50 pages per location, stopping early when your item limit is reached or no more listings appear. 6. **Data push** — each qualifying listing is saved as one record to the Apify dataset. *** ### Tips **Getting 0 results?** - Check your budget range. Furnished rentals in major US cities typically start at $1,000–$2,000/month. A maxBudget under $500 in New York or San Francisco will return nothing. - Check your date format. The actor accepts DD-MM-YYYY and MM/DD/YYYY but will log a warning if it cannot parse the date. - Try a broader search first (no date, no budget) to confirm listings exist for that location, then narrow down. **City not found?** - Use the `City, State` format with a two-letter state abbreviation: `Denver, CO` not `Denver, Colorado`. - For New York City boroughs (Brooklyn, Queens, Bronx, Staten Island), use `New York, NY` — FurnishedFinder groups all five boroughs under one city search. **Multiple locations in one run** - Each location is scraped independently. Results include the `locationSearched` field so you can filter by city in your dataset. - Total results = `maxItems` × number of locations. *** ### Integrations Connect FurnishedFinder Rental Extractor with other tools using [Apify integrations](https://apify.com/integrations). - **Google Sheets** — pipe results directly into a spreadsheet after each run - **Airtable** — sync listings into a base for team review - **Slack** — get a notification when new listings match your criteria - **Webhooks** — trigger any downstream workflow when a run completes - **Make / Zapier** — automate multi-step workflows without code Schedule daily or weekly runs to track how prices and availability change over time across any set of US cities. # Actor input Schema ## `locations` (type: `array`): Cities to search. Enter one per line. Accepted formats: City, State (New York, NY) — City, State, Zip (Austin, TX 78701) — full address (456 Oak Ave, Chicago, IL 60601). At least one location or zip code is required. ## `zipCodes` (type: `array`): US zip codes to search. Enter one per line (e.g. 10001). City and state are resolved automatically for each zip. ## `moveInDate` (type: `string`): Earliest move-in date (YYYY-MM-DD). Applied to all locations. Leave blank to search without a date filter. ## `moveOutDate` (type: `string`): Latest move-out date (YYYY-MM-DD). Use with Move-in date to target a specific rental window. Optional. ## `minBudget` (type: `integer`): Skip listings priced below this amount per month. Leave blank for no minimum. ## `maxBudget` (type: `integer`): Skip listings priced above this amount per month. Leave blank for no maximum. ## `maxItems` (type: `integer`): Maximum listings to collect per location or zip code. If you search 3 locations at 50 items each, you get up to 150 results total. ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## Actor input object example ```json { "locations": [ "New York, NY" ], "moveInDate": "2026-07-15", "moveOutDate": "2026-09-01", "minBudget": 1500, "maxBudget": 5000, "maxItems": 30, "requestTimeoutSecs": 30 } ``` # 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 = { "locations": [ "New York, NY" ], "moveInDate": "2026-06-01" }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/furnishedfinder-rental-extractor").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 = { "locations": ["New York, NY"], "moveInDate": "2026-06-01", } # Run the Actor and wait for it to finish run = client.actor("kawsar/furnishedfinder-rental-extractor").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 '{ "locations": [ "New York, NY" ], "moveInDate": "2026-06-01" }' | apify call kawsar/furnishedfinder-rental-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/furnishedfinder-rental-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FurnishedFinder Rental Extractor", "description": "FurnishedFinder rental extractor that pulls listings by city and move-in date, so you get price, availability, bedrooms, and amenities in one automated run.", "version": "0.0", "x-build-id": "Gdm9P4osFY5SZOivG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~furnishedfinder-rental-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-furnishedfinder-rental-extractor", "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~furnishedfinder-rental-extractor/runs": { "post": { "operationId": "runs-sync-kawsar-furnishedfinder-rental-extractor", "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~furnishedfinder-rental-extractor/run-sync": { "post": { "operationId": "run-sync-kawsar-furnishedfinder-rental-extractor", "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": { "locations": { "title": "Locations", "type": "array", "description": "Cities to search. Enter one per line. Accepted formats: City, State (New York, NY) — City, State, Zip (Austin, TX 78701) — full address (456 Oak Ave, Chicago, IL 60601). At least one location or zip code is required.", "items": { "type": "string" } }, "zipCodes": { "title": "Zip codes", "type": "array", "description": "US zip codes to search. Enter one per line (e.g. 10001). City and state are resolved automatically for each zip.", "items": { "type": "string" } }, "moveInDate": { "title": "Move-in date", "type": "string", "description": "Earliest move-in date (YYYY-MM-DD). Applied to all locations. Leave blank to search without a date filter." }, "moveOutDate": { "title": "Move-out date", "type": "string", "description": "Latest move-out date (YYYY-MM-DD). Use with Move-in date to target a specific rental window. Optional." }, "minBudget": { "title": "Min monthly budget (USD)", "minimum": 0, "type": "integer", "description": "Skip listings priced below this amount per month. Leave blank for no minimum." }, "maxBudget": { "title": "Max monthly budget (USD)", "minimum": 0, "type": "integer", "description": "Skip listings priced above this amount per month. Leave blank for no maximum." }, "maxItems": { "title": "Max items per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum listings to collect per location or zip code. If you search 3 locations at 50 items each, you get up to 150 results total.", "default": 30 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout in seconds.", "default": 30 } } }, "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 } } } } } } } } } } ```