# Furnishedfinder Property Search Scraper (`alexist/furnishedfinder-property-search-scraper`) Actor

Scrape furnished property listings from Furnished Finder with complete rental data. Collect property type, rent, availability, location, amenities, and 20+ additional fields — perfect for real estate investors, property managers, and rental market analysts.

- **URL**: https://apify.com/alexist/furnishedfinder-property-search-scraper.md
- **Developed by:** [Alex](https://apify.com/alexist) (community)
- **Categories:** Automation, Developer tools, Real estate
- **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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Furnished Finder Property Scraper: Extract Rental Listings with Geolocation Data

***

### What Is Furnished Finder?

Furnished Finder (furnishedfinder.com) is a specialized real estate platform for furnished rentals, corporate housing, and short-term leases. It connects property owners with tenants seeking temporary or flexible housing solutions. With thousands of listings across the US and internationally, manually gathering property data is labor-intensive. The **Furnished Finder Property Scraper** automates this process, delivering structured rental data in seconds.

***

### Overview

The **Furnished Finder Property Scraper** extracts detailed property listings from search results, capturing comprehensive rental information. It is ideal for:

- **Real estate investors** tracking rental inventory and market rates
- **Property managers** aggregating listings for competitive analysis
- **Rental platforms** building datasets to feed secondary job boards
- **Market researchers** analyzing furnished rental trends by location and budget
- **Relocation services** providing clients with curated property options

Key features include geolocation-based filtering, dynamic budget parameters, availability tracking, and support for bulk URL ingestion via `max_items_per_url` limits.

***

### Input Format

The scraper accepts a JSON configuration with search-specific parameters:

```json
{
  "urls": [
    "https://www.furnishedfinder.com/housing/us--ca--long-beach?moveDate={\"in\":\"2024-12-24\"}&budget={\"max\":10000}&filters={}&page&map={\"zoomLevel\":11.83,\"min\":{\"latitude\":33.686,\"longitude\":-118.256},\"max\":{\"latitude\":33.941,\"longitude\":-118.036}}"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}
```

| Field | Description |
|---|---|
| `urls` | Array of Furnished Finder search result pages with filters applied |
| `max_items_per_url` | Maximum listings to extract per URL (recommended: 200–300) |
| `ignore_url_failures` | If `true`, continues scraping even if individual URLs fail |

#### URL Parameters Explained

Furnished Finder URLs include encoded query strings:

- **`moveDate`** — Target move-in date (e.g., `2024-12-24`)
- **`budget`** — Max monthly rent filter (e.g., `{"max": 10000}`)
- **`filters`** — Additional criteria (property type, amenities, pet policies)
- **`map`** — Geobounding box with zoom level and coordinate bounds for location filtering

> **Tip:** Extract these URLs directly from Furnished Finder's search interface after applying your desired filters. The scraper will preserve all filter logic automatically.

***

### Output Format

**Sample output**

```json
{
  "property_type": "House",
  "property_type_class": "entire_unit",
  "approx_location": {
    "latitude": 33.821154,
    "longitude": -118.173904,
    "__typename": "LatLng"
  },
  "name": "California Heights Historical Home with Tropical Spanish Backyard Oasis",
  "listing_id": "1015153_1",
  "laundry_type": "SHARED",
  "description": "",
  "encoded_location_name": "us--ca--long-beach",
  "available_on_date": "Available: Sep. 07, 2026",
  "is_available_now": false,
  "is_fully_available": null,
  "minimum_stay_in_days": 30,
  "best_matched_availability_window": null,
  "future_availability_window": null,
  "photos": [
    {
      "url": "https://staticproperties.furnishedfinder.com/1015153/1/1015153_1_66149169-full.JPG",
      "is_featured": true,
      "__typename": "Image"
    },
    {
      "url": "https://staticproperties.furnishedfinder.com/1015153/1/1015153_1_66149167-full.JPG",
      "is_featured": false,
      "__typename": "Image"
    },
    {
      "url": "https://staticproperties.furnishedfinder.com/1015153/1/1015153_1_66149173-full.JPG",
      "is_featured": false,
      "__typename": "Image"
    },
    {
      "url": "https://staticproperties.furnishedfinder.com/1015153/1/1015153_1_66149168-full.JPG",
      "is_featured": false,
      "__typename": "Image"
    },
    {
      "url": "https://staticproperties.furnishedfinder.com/1015153/1/1015153_1_66149170-full.JPG",
      "is_featured": false,
      "__typename": "Image"
    }
  ],
  "rent_amount": {
    "amount": "$$4,000/month",
    "currency": "USD",
    "__typename": "Money"
  },
  "total_sleeps": 5,
  "bedroom_count": 2,
  "bathroom_count": 1.5,
  "bathroom_type": null,
  "amenities": [
    "airConditioning",
    "cleaningProducts",
    "cleaningProductsForBathroom",
    "closeToPublicTransportation",
    "diningTable",
    "dishwasher",
    "dresser",
    "essentialsKitchenwareBathwareLinens",
    "fencedYard",
    "fireExtinguisher",
    "firstAidKit",
    "freeParkingOnPremises",
    "fullSizeFridge",
    "gameConsole",
    "gated",
    "hairDryer",
    "heating",
    "hotTub",
    "housekeeping",
    "ironBoard",
    "kitchen",
    "kitchenEssentials",
    "microwave",
    "nonSmoking",
    "outdoorGrill",
    "parking",
    "pool",
    "quietEnvironment",
    "roomDarkeningShades",
    "smartTV",
    "smokeDetector",
    "starterToiletries",
    "storage",
    "stoveTop",
    "utilitiesIncluded",
    "washeranddryeronpremises",
    "wifi"
  ],
  "is_favorite": false,
  "is_region_match": true,
  "from_url": "https://www.furnishedfinder.com/housing/us--ca--long-beach?moveDate=%7B%22in%22%3A%222024-12-24%22%7D&budget=%7B%22max%22%3A10000%7D&filters=%7B%7D&page&map=%7B%22zoomLevel%22%3A11.83564856492675%2C%22min%22%3A%7B%22latitude%22%3A33.686019118014094%2C%22longitude%22%3A-118.25589179992676%7D%2C%22max%22%3A%7B%22latitude%22%3A33.94064315565586%2C%22longitude%22%3A-118.03616523742676%7D%7D"
}
```

Each property listing returns a comprehensive record with 21 core fields:

#### Property Identification & Type

| Field | Meaning |
|---|---|
| `Listing ID` | Unique identifier for the property in Furnished Finder's system |
| `Name` | Property display name or title |
| `Property Type` | General category (e.g., apartment, house, condo, room) |
| `Property Type Class` | Subclassification (e.g., studio, 1-bed, 2-bed) |
| `Encoded Location Name` | URL-friendly location string (e.g., `us--ca--long-beach`) |
| `Approx Location` | Approximate address or neighborhood description shown to renters |

#### Availability & Lease Terms

| Field | Meaning |
|---|---|
| `Available On Date` | Earliest move-in date the property allows |
| `Is Available Now` | Boolean flag—`true` if the unit is immediately available |
| `Is Fully Available` | Boolean flag—`true` if all units in the listing are open |
| `Minimum Stay In Days` | Minimum lease duration required (e.g., 30 days for short-term) |
| `Best Matched Availability Window` | Optimal availability range matching the search query |
| `Future Availability Window` | Next expected availability if currently unavailable |

#### Financial & Capacity

| Field | Meaning |
|---|---|
| `Rent Amount` | Monthly rent in USD (reflects any filters applied in the search) |
| `Total Sleeps` | Total occupancy capacity (e.g., 4 people) |
| `Bedroom Count` | Number of bedrooms |
| `Bathroom Count` | Number of bathrooms |

#### Features & Amenities

| Field | Meaning |
|---|---|
| `Bathroom Type` | Specification of bathroom(s) (e.g., private, shared, ensuite) |
| `Laundry Type` | Laundry availability (e.g., in-unit, on-site, none) |
| `Amenities` | Comma-separated list of amenities (WiFi, parking, gym, washer, etc.) |
| `Description` | Full property description in HTML or plain text |

#### User Engagement & Matching

| Field | Meaning |
|---|---|
| `Photos` | Array of photo URLs for the listing |
| `Is Favorite` | Boolean—`true` if the listing is bookmarked by the current user session |
| `Is Region Match` | Boolean—`true` if the property matches the search region parameters |

***

### How to Use

1. **Build your search** — Visit furnishedfinder.com and apply filters (location, budget, move date, property type, amenities).
2. **Copy the URL** — Once filtered, copy the complete URL from your browser's address bar (includes all query parameters).
3. **Configure the input** — Paste URL(s) into the `urls` array. Set `max_items_per_url` based on expected result count.
4. **Run the scraper** — Start the actor and monitor progress in the run log.
5. **Export your data** — Download results as JSON, CSV, or Excel for analysis, comparison, or integration.

**Best practices:**

- Use geolocation filters in your search URL to narrow scope and reduce runtime.
- Set `max_items_per_url` to 200–300 for typical city searches; increase for broad regional queries.
- Enable `ignore_url_failures` when scraping multiple URLs to handle temporary site issues gracefully.

***

### Use Cases & Business Value

- **Investment analysis:** Compare rent prices, occupancy, and amenities across neighborhoods
- **Market research:** Identify emerging furnished rental trends and gaps in supply
- **Competitive benchmarking:** Monitor competitor listings and pricing strategies
- **Lead generation:** Build curated property datasets for relocation agencies or corporate housing firms

The Furnished Finder Property Scraper transforms hours of manual browsing into minutes of automated data collection, feeding reliable market intelligence directly into your workflows.

***

### Conclusion

The **Furnished Finder Property Scraper** is your essential tool for extracting large-scale furnished rental data with precision. With 21 rich fields covering location, pricing, availability, and amenities, it empowers real estate professionals, investors, and researchers to make data-driven decisions faster. Deploy it today and unlock deeper insights into the furnished rental market.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.furnishedfinder.com/housing/us--ca--long-beach?moveDate=%7B%22in%22%3A%222024-12-24%22%7D&budget=%7B%22max%22%3A10000%7D&filters=%7B%7D&page&map=%7B%22zoomLevel%22%3A11.83564856492675%2C%22min%22%3A%7B%22latitude%22%3A33.686019118014094%2C%22longitude%22%3A-118.25589179992676%7D%2C%22max%22%3A%7B%22latitude%22%3A33.94064315565586%2C%22longitude%22%3A-118.03616523742676%7D%7D"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 300
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.furnishedfinder.com/housing/us--ca--long-beach?moveDate=%7B%22in%22%3A%222024-12-24%22%7D&budget=%7B%22max%22%3A10000%7D&filters=%7B%7D&page&map=%7B%22zoomLevel%22%3A11.83564856492675%2C%22min%22%3A%7B%22latitude%22%3A33.686019118014094%2C%22longitude%22%3A-118.25589179992676%7D%2C%22max%22%3A%7B%22latitude%22%3A33.94064315565586%2C%22longitude%22%3A-118.03616523742676%7D%7D"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 300
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/furnishedfinder-property-search-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.furnishedfinder.com/housing/us--ca--long-beach?moveDate=%7B%22in%22%3A%222024-12-24%22%7D&budget=%7B%22max%22%3A10000%7D&filters=%7B%7D&page&map=%7B%22zoomLevel%22%3A11.83564856492675%2C%22min%22%3A%7B%22latitude%22%3A33.686019118014094%2C%22longitude%22%3A-118.25589179992676%7D%2C%22max%22%3A%7B%22latitude%22%3A33.94064315565586%2C%22longitude%22%3A-118.03616523742676%7D%7D"],
    "ignore_url_failures": True,
    "max_items_per_url": 300,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/furnishedfinder-property-search-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 '{
  "urls": [
    "https://www.furnishedfinder.com/housing/us--ca--long-beach?moveDate=%7B%22in%22%3A%222024-12-24%22%7D&budget=%7B%22max%22%3A10000%7D&filters=%7B%7D&page&map=%7B%22zoomLevel%22%3A11.83564856492675%2C%22min%22%3A%7B%22latitude%22%3A33.686019118014094%2C%22longitude%22%3A-118.25589179992676%7D%2C%22max%22%3A%7B%22latitude%22%3A33.94064315565586%2C%22longitude%22%3A-118.03616523742676%7D%7D"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 300
}' |
apify call alexist/furnishedfinder-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=alexist/furnishedfinder-property-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/xZi044wqf51vBxZhe/builds/XbQwsXwLSdZvQnT8h/openapi.json