# Furnished Finder Listings and Host Contact Info (`datascrapers/furnishedfinder-listings-and-host-contact-info`) Actor

Return Furnished Finder listings, optional property-page details, host profiles, and host phone numbers from the published US dataset.

- **URL**: https://apify.com/datascrapers/furnishedfinder-listings-and-host-contact-info.md
- **Developed by:** [Data Scrapers](https://apify.com/datascrapers) (community)
- **Security:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 listings

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

**Furnished Finder Listings and Host Contact Info** gives instant access to a structured dataset of Furnished Finder housing records. Each dataset item is one listing and can include rent, availability, property type, photos, the linked host profile, and the host phone number. Query a city such as Austin, select one or more US states, paste a Furnished Finder housing or property URL, or pass listing ids. Limit results with `maxItems`, then retrieve records through the Apify Dataset API or export them as JSON, CSV, Excel, XML, or another supported format. The inventory covers close to a million Furnished Finder listings, each linked to a host. Paid users can add host phone numbers.

[![Furnished Finder Listings and Host Contact Info — input to structured data](https://raw.githubusercontent.com/faizanalii/apify-actor-assets/main/furnishedfinder-listings-and-host-contact-info/furnishedfinder-listings-and-host-contact-info-value-demo.gif)](https://apify.com/datascrapers/furnishedfinder-listings-and-host-contact-info)

### Dataset at a glance

| Property | Value |
|---|---|
| Source | Furnished Finder (`furnishedfinder.com`) |
| Record unit | One listing |
| Input methods | `searchQuery`, `searchQueries`, `states`, `urls`, `listingIds` |
| Main identifiers | `listingId`, `url` |
| Delivery | Apify Dataset and API |
| Export formats | JSON, CSV, Excel, XML, and other Apify dataset exports |
| Update model | Instant access to the current inventory per run; extra listings are added only when you request more than that inventory already has |
| Pricing | $1.00 per 1,000 listings on Free ($0.80 per 1,000 on Gold, Platinum, and Diamond) |

### Coverage and available records

The Actor returns Furnished Finder listings for US locations. `searchQuery` and `searchQueries` accept a city (`Austin`) or a city and state (`Atlanta, GA`). `states` returns every listing for each selected state. `urls` accepts housing search URLs or property URLs. `listingIds` accepts ids such as `1046391_1`.

`listingDetails` adds property-page fields such as fees, house rules, reviews, coordinates, and the full description. `hostInfo` adds the linked host profile. `hostPhoneNumber` adds `hostPhone` for paying customers. Free users receive `Phone number is only available for paid users.` when that option is on.

`maxItems` caps the number of listings. `0` means no cap. Optional `minPrice`, `maxPrice`, and `moveInDate` filter monthly rent and availability. When the current inventory already covers the requested count, the run returns those records immediately.

The Actor does not collect bookings, messages, or login-only host dashboards.

### Data dictionary

| Field | Type | Nullable | Description | Example |
|---|---|---:|---|---|
| listingId | string | No | Furnished Finder listing id used for deduplication | 1000302_1 |
| url | string | No | Property URL | https://www.furnishedfinder.com/property/1000302_1 |
| name | string | Yes | Listing or host display name | Monica Vela |
| image | string | Yes | Primary photo URL | https://staticproperties.furnishedfinder.com/1000302/1/1000302_1_63569219-full.jpg |
| sourceQuery | string | Yes | Query, URL, or state that produced the row | Austin |
| propertyType | string | Yes | Property type | House |
| propertyTypeClass | string | Yes | Occupancy class | entire_unit |
| description | string | Yes | Listing description | Welcome to this cozy Zen-inspired home… |
| encodedLocationName | string | Yes | Location slug | us--tx--austin |
| availableOnDate | string | Yes | Availability label from the source | Available: Dec. 31, 2026 |
| isAvailableNow | boolean | Yes | Whether the listing is currently available | false |
| minimumStayInDays | integer | Yes | Minimum stay in days | 30 |
| rentAmount | object | Yes | Monthly rent (`amount`, `currency`) | `{"amount":"2500.00","currency":"USD"}` |
| bedroomCount | number | Yes | Bedroom count | 3 |
| bathroomCount | number | Yes | Bathroom count | 2 |
| bathroomType | string | Yes | Bathroom type | Private Bath |
| laundryType | string | Yes | Laundry type | In-Unit W/D |
| totalSleeps | integer | Yes | Sleeps | 6 |
| amenities | array | Yes | Amenity keys | `["wifi","kitchen"]` |
| photos | array | Yes | Photo objects with `url` | See example record |
| approxLocation | object | Yes | Approximate latitude and longitude | `{"latitude":30.1464663,"longitude":-97.842884}` |
| host_info | object | Yes | Host profile when `hostInfo` is on | See example record |
| hostPhone | string | Yes | Host phone when `hostPhoneNumber` is on | (820) 345-7198 |
| user_info | object | Yes | Property-page user object when `listingDetails` is on | — |
| house_rules | array | Yes | House rules when `listingDetails` is on | — |
| fees | array | Yes | Fees when `listingDetails` is on | — |
| reviews | array | Yes | Reviews when `listingDetails` is on | — |
| coordinates | object | Yes | Coordinates when `listingDetails` is on | — |
| appearances | array | Yes | City and county appearances for the listing | Austin / Travis |

`listingId` is the stable deduplication key.

### Example dataset record

Produced by `searchQuery: "Austin"` with `hostInfo` and `hostPhoneNumber` on.

```json
{
  "listingId": "1000302_1",
  "url": "https://www.furnishedfinder.com/property/1000302_1",
  "name": "Monica Vela",
  "sourceQuery": "Austin",
  "propertyType": "House",
  "propertyTypeClass": "entire_unit",
  "encodedLocationName": "us--tx--austin",
  "availableOnDate": "Available: Dec. 31, 2026",
  "isAvailableNow": false,
  "minimumStayInDays": 30,
  "rentAmount": {
    "amount": "2500.00",
    "currency": "USD"
  },
  "bedroomCount": 3,
  "bathroomCount": 2,
  "bathroomType": "Private Bath",
  "laundryType": "In-Unit W/D",
  "totalSleeps": 6,
  "image": "https://staticproperties.furnishedfinder.com/1000302/1/1000302_1_63569219-full.jpg",
  "hostPhone": "(820) 345-7198",
  "host_info": {
    "Fname": "Monica",
    "Lname": "Vela",
    "username": "monica.vela81",
    "phone": "(820) 345-7198",
    "Hcity": "Austin",
    "Hstate": "TX"
  }
}
```

Long description, photo arrays, and extra host fields are omitted here.

### Query and input reference

| Input | Type | Required | Default | Accepted values | Description |
|---|---|---:|---|---|---|
| urls | array | No | — | Housing or property URLs | Furnished Finder search or property links |
| states | array | No | — | US state codes | Returns every listing in each selected state |
| searchQuery | string | No | — | City or city, state | One location, for example `Austin` |
| searchQueries | array | No | — | City or city, state | Additional locations |
| listingIds | array | No | — | `123_1` ids | Specific listing ids |
| maxItems | integer | No | 0 | ≥ 0 | Result cap. `0` means no cap |
| listingDetails | boolean | No | false | true / false | Add property-page fields and charge `listing-details` |
| hostInfo | boolean | No | false | true / false | Add the host profile and charge `host-info` |
| hostPhoneNumber | boolean | No | false | true / false | Add host phone for paying customers and charge `host-phone-number` when a real number is returned |
| moveInDate | string | No | — | YYYY-MM-DD | Keep listings available on or before this date |
| moveOutDate | string | No | — | YYYY-MM-DD | Desired move-out date |
| minPrice | integer | No | — | ≥ 0 | Minimum monthly rent in USD |
| maxPrice | integer | No | — | ≥ 0 | Maximum monthly rent in USD |
| proxyConfiguration | object | No | Residential US | Apify proxy object | Used when extra listings are requested |

Provide at least one of `urls`, `states`, `searchQuery`, `searchQueries`, or `listingIds`.

Minimal request:

```json
{
  "searchQuery": "Austin",
  "maxItems": 10
}
```

Advanced request:

```json
{
  "searchQueries": ["Austin", "Atlanta, GA"],
  "states": ["TX"],
  "maxItems": 100,
  "listingDetails": true,
  "hostInfo": true,
  "hostPhoneNumber": true,
  "minPrice": 800,
  "maxPrice": 4000,
  "moveInDate": "2026-12-01"
}
```

### Retrieve the data through the API

1. Start the Actor with JSON input.
2. Wait for the run or use the synchronous dataset endpoint.
3. Read items from the run’s default dataset.
4. Paginate or export the dataset.

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("datascrapers/furnishedfinder-listings-and-host-contact-info").call(run_input={
    "searchQuery": "Austin",
    "maxItems": 10,
    "hostInfo": True,
    "hostPhoneNumber": True,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("listingId"), item.get("rentAmount"), item.get("hostPhone"))
```

Use the Actor API tab in Apify Console for other languages. Never place a real token in a URL or example.

### Data quality and record handling

Deduplicate on `listingId`. `url` is a second identifier. Host fields are absent when `hostInfo` is off. `hostPhone` is absent when `hostPhoneNumber` is off. Paying customers receive the phone when one exists; free users receive the paid-only placeholder. `listingDetails` fields are absent when that option is off. Each run writes a new dataset.

### Export and pipeline examples

| Destination | Recommended method | Typical use |
|---|---|---|
| Spreadsheet | CSV or Excel export | Manual review of rents and hosts |
| PostgreSQL or Supabase | Dataset API or webhook consumer | Inventory and outreach tables |
| Google Sheets | Apify integration | Shared market snapshots |
| Cloud storage | Scheduled dataset export | Recurring city extracts |

### Pricing and cost examples

Pay per event. Prices below are per event, not per 1,000, except where noted. Platinum and Diamond use the Gold rate. `apify-actor-start` is $0.00005 once per run. Platform usage is billed separately.

| Event | Free | Bronze | Silver | Gold |
|---|---:|---:|---:|---:|
| listing | $0.001 | $0.001 | $0.0009 | $0.0008 |
| listing-details | $0.001 | $0.001 | $0.0009 | $0.0008 |
| host-info | $0.001 | $0.001 | $0.0009 | $0.0008 |
| host-phone-number | $0.001 | $0.001 | $0.0009 | $0.0008 |

That is **$1.00 per 1,000 listings** on Free and **$0.80 per 1,000 listings** on Gold. Optional events are charged only when those fields are returned. Host phone is charged only when a real number is returned to a paying user.

| Listings | Listing-only cost (Free) | Listing + host + phone (Free) |
|---:|---:|---:|
| 1,000 | $1.00 | $3.00 |
| 10,000 | $10.00 | $30.00 |

Estimates exclude Actor start and platform usage.

### Limitations and responsible data use

Records come from Furnished Finder listings that are available to the Actor. Field presence depends on the source listing and the options you enable. The Actor does not keep a historical snapshot after the run unless you store the dataset. Users are responsible for privacy, contractual, and legal compliance when using host names and phone numbers.

### Dataset questions

#### What does one dataset item represent?

One Furnished Finder listing. Optional host and detail fields attach to that same item.

#### Which field should I use as a unique identifier?

Use `listingId`. Use `url` if you need a public link.

#### Are host phone numbers included by default?

No. Turn on `hostPhoneNumber`. Paying customers receive the phone when it is available. Free users receive `Phone number is only available for paid users.`

#### How do I get instant access to a large inventory?

Enter a city, state, URL, or listing id. When the current inventory already covers `maxItems`, the Actor returns those listings immediately.

#### Can I retrieve the records as CSV or JSON?

Yes. Download the dataset as JSON, CSV, Excel, XML, or another Apify export, or read it through the Dataset API.

#### What counts as a billable result?

Each listing charges `listing`. `listing-details`, `host-info`, and `host-phone-number` are extra events and fire only when those fields are returned.

#### Does the Actor return historical data?

No. Each run returns the current inventory for the query. Keep the dataset if you need a snapshot.

### Related datasets from Data Scrapers

- **[Furnished Finder Scraper](https://apify.com/datascrapers/furnishedfinder)** — Live Furnished Finder search when you want a crawl-only run instead of this instant inventory.
- **[Apartments.com Scraper](https://apify.com/datascrapers/apartments-scraper)** — US rental listings that can sit beside Furnished Finder inventory.
- **[Airbnb Scraper](https://apify.com/datascrapers/airbnb-scraper)** — Short-term listings for the same cities you query here.
- **[Realtor.com Scraper](https://apify.com/datascrapers/realtor-scraper)** — For-sale and rental records for broader housing analysis.
- **[Trulia Scraper](https://apify.com/datascrapers/trulia-scraper)** — Sale and rental cards with a shared city query pattern.
- **[Zillow Agents Scraper](https://apify.com/datascrapers/zillow-agents-scraper)** — Agent contacts when you need brokerage outreach next to Furnished Finder hosts.

### Data Scrapers support

Need an additional field, record type, or export workflow? Open an issue on the [Actor page](https://apify.com/datascrapers/furnishedfinder-listings-and-host-contact-info). Include a sample Furnished Finder URL, required fields, expected record volume, and preferred delivery format.

# Actor input Schema

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

Housing search URLs or property URLs (e.g. 'https://www.furnishedfinder.com/housing/us--ga--atlanta'). Optional if states, searchQueries, or listingIds is provided.

## `states` (type: `array`):

One or more US states. Each selected state returns every listing in that state.

## `searchQuery` (type: `string`):

One location such as Austin or Atlanta, GA. City-only names are resolved automatically.

## `searchQueries` (type: `array`):

Additional locations (e.g. \['Austin', 'Atlanta, GA']). City-only names are resolved automatically. Stored matches are returned first, then new listings from a live search.

## `listingIds` (type: `array`):

Furnished Finder listing ids such as '1046391_1'. Optional.

## `maxItems` (type: `integer`):

Maximum number of listings to return (0 = unlimited).

## `listingDetails` (type: `boolean`):

Add property-page fields (fees, house rules, reviews, coordinates, and the full description). Charged as listing-details. Off by default.

## `hostInfo` (type: `boolean`):

Add the host profile for each listing. Charged as host-info. Off by default.

## `hostPhoneNumber` (type: `boolean`):

Add the host phone number for paying customers. Free users receive 'Phone number is only available for paid users.' Charged as host-phone-number only when a real number is returned. Off by default.

## `moveInDate` (type: `string`):

Keep listings available on or before this date (YYYY-MM-DD). Optional.

## `moveOutDate` (type: `string`):

Desired move-out date (YYYY-MM-DD). Optional.

## `minPrice` (type: `integer`):

Minimum monthly rent in USD. Optional.

## `maxPrice` (type: `integer`):

Maximum monthly rent in USD. Optional.

## `proxyConfiguration` (type: `object`):

Proxy settings. Optional.

## Actor input object example

```json
{
  "urls": [
    "https://www.furnishedfinder.com/housing/us--ga--atlanta"
  ],
  "searchQuery": "Austin",
  "maxItems": 10,
  "listingDetails": false,
  "hostInfo": false,
  "hostPhoneNumber": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

Default dataset containing listing records

## `run` (type: `string`):

Link to the run in Apify Console

## `runStats` (type: `string`):

Key-value store record with record counts and timestamps

# 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--ga--atlanta"
    ],
    "searchQuery": "Austin",
    "maxItems": 10,
    "listingDetails": false,
    "hostInfo": false,
    "hostPhoneNumber": false,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("datascrapers/furnishedfinder-listings-and-host-contact-info").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--ga--atlanta"],
    "searchQuery": "Austin",
    "maxItems": 10,
    "listingDetails": False,
    "hostInfo": False,
    "hostPhoneNumber": False,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("datascrapers/furnishedfinder-listings-and-host-contact-info").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 '{
  "urls": [
    "https://www.furnishedfinder.com/housing/us--ga--atlanta"
  ],
  "searchQuery": "Austin",
  "maxItems": 10,
  "listingDetails": false,
  "hostInfo": false,
  "hostPhoneNumber": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call datascrapers/furnishedfinder-listings-and-host-contact-info --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datascrapers/furnishedfinder-listings-and-host-contact-info"
        }
    }
}
```

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 <APIFY_API_TOKEN>` 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/iuq2axVCdzEgAlsRu/builds/ie8LFmWebhcl7jqt4/openapi.json