# Zillow Message Inbox Export - Rental & Buying Chats (`clearpath/zillow-message-inbox-api`) Actor

Export Zillow rental and buying conversations to JSON for CRM updates or records. Choose previews or available message history. Pay per exported conversation; repeated exports are charged again. Check exportSummary for partial results.

- **URL**: https://apify.com/clearpath/zillow-message-inbox-api.md
- **Developed by:** [ClearPath](https://apify.com/clearpath) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Features:** Full permissions
- **Stats:** 6 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.90 / 1,000 conversation exporteds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

## Zillow Message Inbox API | Extract Rental & Buying Conversations

[![Zillow conversations. Contact details included. Phone numbers. Message history. Reply status.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/zillow-message-inbox-api-readme-hero-v1.png)](https://console.apify.com/actors/skl5evdFtHhSSNRQW/input)

From **Clearpath**, creators of [Zillow Bulk Search](https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper) and [Zillow Contact](https://apify.com/clearpath/zillow-contact-message-api). Connect property research, outreach and conversation exports.

### Why choose this actor?

- **Keep the contact with the conversation.** Export landlord phone numbers and agent contact details alongside your messages and property information, where Zillow provides them. Rental email addresses may be Zillow relay addresses.
- **Export rental and buying inboxes together.** Choose either inbox or both. Enable message history to collect more than the default conversation previews, including message text, senders and timestamps.
- **See which rental inquiries need attention.** Get unread and not-replied-to flags, inbox counts and application status where available. Bring that context into your CRM or follow-up workflow.

<a href="https://console.apify.com/actors/skl5evdFtHhSSNRQW/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/zillow-message-inbox-api-readme-cta-v1.svg" width="230" height="48" alt="Export your Zillow inbox"></a>

### Export your first conversations

Use your own Zillow account credentials. This example selects both inboxes and enables message history.

```json
{
  "mode": "both",
  "email": "you@example.com",
  "password": "YOUR_ZILLOW_PASSWORD",
  "fetchFullConversations": true
}
```

[Open actor input](https://console.apify.com/actors/skl5evdFtHhSSNRQW/input) to enter your credentials securely, or use your own session cookies. Export JSON to preserve nested messages and contacts. Check the [Pricing tab](https://apify.com/clearpath/zillow-message-inbox-api/pricing) for current charges.

The rental inbox returns up to 60 conversations; expanded buying threads include up to 250 messages each. Message-history mode takes longer and does not guarantee a complete account archive. The hero shows an example conversation.

<table>
<tr><td colspan="5" style="padding:10px 12px;background:#006AFF;border:none"><strong style="color:#FFFFFF;font-size:14px">Clearpath · Zillow Suite</strong></td></tr>
<tr>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-o7HmXfwKe2eunRYXI-9A6dajayVT-zillow-bulk-search-unlimited-scraper-logo.png.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Bulk Search</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Larger searches</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-qEF4wZM7dQpm1ebJ3-8ed2mYypPN-zillow-zip-code-search-scraper.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-zip-code-search-scraper" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">ZIP Search</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Local listings</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-WOsEeX3kiEAVP3y0C-tbE8tfRWNS-zillow-contact-message-api-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-contact-message-api" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Contact</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Send inquiries</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-vGu8Ujn448eqOjb6g-GZ9eLLaEOR-zillow-rental-application-submitter-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-rental-application-submitter" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Auto Apply</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Rental requests</span></td>
<td style="padding:10px 11px;background:#D8E4FF;border:1px solid #CBD8EF;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-skl5evdFtHhSSNRQW-K6oSwOZwSN-zillow-inbox-actor-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-message-inbox-api" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Inbox</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">You are here</span></td>
</tr>
</table>

### Pricing

**$0.01 per exported conversation**, flat across Apify plans. Platform usage is included.

A conversation counts once per inbox type within a run. Exporting it again in another run incurs another charge, even if there are no new messages. Optional message history is included in the conversation price. Failed conversation exports and test simulations incur no conversation charge.

| Conversation-export charges | Price |
| --- | ---: |
| 10 conversations | $0.10 |
| 60 conversations | $0.60 |
| 1,000 conversations across exports | $10.00 |

This Actor exports snapshots. It does not track only new messages across runs. Frequent exports of the same inbox will repeatedly charge for the conversations returned.

### Quick start

```json
{
  "email": "you@example.com",
  "password": "your-password",
  "mode": "rental",
  "fetchFullConversations": false
}
```

Alternatively, supply `cookies` as a browser cookie string, JSON object or JSON array exported by a cookie extension. Cookies take priority when both methods are supplied. Use an account you are authorized to access.

| Input | Description |
| --- | --- |
| `email`, `password` | Credentials for your Zillow account. Supply both unless using cookies. |
| `cookies` | Optional manual session cookies. Treat them as a password. |
| `mode` | `rental`, `buying` or `both`. Defaults to `rental`. |
| `fetchFullConversations` | Include available history for each conversation. Defaults to `false` for previews. |

Saved sessions are separated by Apify user and Zillow email. Expired or rejected sessions may require a fresh login. Credentials remain sensitive Actor input; this Actor does not add them or message contents to its usage telemetry.

### Output

The Actor preserves the nested output format: one dataset record with `rental`, `buying`, `mode` and `scrapedAt`. Each exported inbox contains a `conversations` array. Conversation and message fields returned by Zillow are preserved.

`exportSummary` reports the number of exported conversations, whether the budget limited the export, failed inboxes and failed history expansions. A failed inbox has an `error` field. Check this summary before treating an export as complete.

When message history is requested, conversations whose history cannot be fetched are omitted and not charged. Other successfully exported conversations remain available. Empty inboxes have no conversation charge.

### Coverage and limits

Rental exports currently include up to the first 60 conversations returned by Zillow. Buying exports include the conversations returned by Zillow. Available buying history is limited to 250 messages per conversation. Rental histories that exceed the bounded export window are omitted; unusually large or slow histories can also be omitted. This is not a guaranteed complete archive of every historical conversation or message.

The Actor checks the budget before authentication and limits conversation selection before fetching history. A run may return fewer conversations when its budget is too small. There is no additional per-message or login event.

An interrupted export with uncertain storage or billing stops for review rather than automatically repeating the export. Check saved results before starting a new run.

### Copy to your AI assistant

```text
Use clearpath/zillow-message-inbox-api on Apify to export rental/buying conversation snapshots. Inputs: email+password or cookies, mode=rental|buying|both, fetchFullConversations=false by default. Output: one nested dataset record with rental/buying.conversations and exportSummary. Price: $0.01 per exported conversation; platform usage included. Re-exporting the same conversation in a new run is billable again. Optional available history is included; failed expansions are omitted and not charged. Rental list coverage currently up to 60 conversations; buying history up to 250 messages per conversation. Inspect partial/budget indicators; do not assume a complete archive or new-message-only synchronization.
```

[Open the Actor](https://console.apify.com/actors/skl5evdFtHhSSNRQW)

# Actor input Schema

## `email` (type: `string`):

Your Zillow email. Provide a password too, or use manual cookies. Saved sessions are separated by account.

## `password` (type: `string`):

Your Zillow password. Required when using email login. This is sensitive Actor input.

## `cookies` (type: `string`):

Your session cookies as a browser cookie string, JSON object or cookie-extension JSON array. Takes priority over email/password. Keep these secret.

## `mode` (type: `string`):

Select which inbox conversations to fetch:

• Rental Hub Inbox: Fetch rental conversations (property managers, landlords)
• Buying Inbox: Fetch buying conversations (real estate agents, sellers)
• Both: Fetch both rental and buying conversations

## `fetchFullConversations` (type: `boolean`):

Include available messages for each conversation. Failed history exports are omitted and not charged. Large or slow histories may be omitted. Buying history is limited to 250 messages per conversation.

## Actor input object example

```json
{
  "email": "your.email@example.com",
  "cookies": "zgsession=...; loginmemento=...; _px3=...; ZILLOW_SID=...; zjs_user_id=...",
  "mode": "rental",
  "fetchFullConversations": false
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("clearpath/zillow-message-inbox-api").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("clearpath/zillow-message-inbox-api").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 '{}' |
apify call clearpath/zillow-message-inbox-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpath/zillow-message-inbox-api"
        }
    }
}
```

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/skl5evdFtHhSSNRQW/builds/Sccuti0IwgPeePmrd/openapi.json
