> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# realestate.com.au Setup

> Connect realestate.com.au (REA), sync active and sold listings, and understand the data fields REA's feed exposes.

realestate.com.au (REA) is one of Australia's two major property portals. Connecting it lets your active listings flow into Voqo's Knowledge Base automatically, and — when you opt in — your sold and leased listings as well, so your AI agent can speak to your recent sales on calls.

Once connected, Voqo keeps itself in step with REA on a scheduled sync. No manual exports or uploads.

## Prerequisites

* **Workspace admin** role (required to manage integrations)
* A realestate.com.au account with feed access
* Your REA agency details ready to enter

## Connect realestate.com.au

1. Go to **Integrations** in the sidebar.
2. Find the **realestate.com.au** card and click **Connect**.
3. Provide your agency details and confirm the connection.
4. Pick what to sync (see [Pick your sync scope](#pick-your-sync-scope) below).
5. Click **Connect**.

If your credentials are valid, listing sync begins automatically in the background. The first sync brings in your active stock; subsequent scheduled syncs pull in any state changes (sold, leased, off-market) on those listings.

## Pick your sync scope

You'll see the following scope options:

* **Live listings** — always on. Your active sale and rental stock flows into the Knowledge Base automatically.
* **Sold & off-market listings** — opt-in. Retain sold residential listings and off-market listings in your Knowledge Base with a **Sold** or **Off-Market** badge instead of silently removing them.
* **Leased listings** — opt-in. Retain leased rental listings in your Knowledge Base with a **Leased** badge.

REA does not have a pre-market stage in its feed (it's a portal, not a CRM), so there's no pre-market option here. If you need pre-market data, that lives in your CRM integration (Eagle MRI, AgentBox, or VaultRE).

You can change these later via the **⋮** Settings on the realestate.com.au card.

### Choose how far back to keep sold and leased listings

When you enable **Sold & off-market listings** or **Leased listings**, a **Historical listing window** selector appears in your realestate.com.au settings. It controls how far back Voqo includes sold, leased, and off-market listings on the next sync, based on when each listing was last updated.

* **Pick a window** — **Last 1 month**, **Last 3 months**, **Last 6 months**, **Last 12 months** (the default), or **Last 24 months**.
* **Older listings roll off automatically.** A sold or leased listing that hasn't been updated within your chosen window drops out of your Knowledge Base on the next sync.
* **Widen the window to bring older listings back.** Switch to a longer window and run a sync — the older sold and leased listings reappear.
* **The selector only shows when Sold or Leased is enabled.** Your live listings always sync in full and are never affected by this window.

### Turning a scope off — and getting your listings back

When you turn **off** a listing scope in your realestate.com.au settings, Voqo **removes** the already-synced listings of that type from your Knowledge Base. Because this removes records, Voqo always asks you to confirm first:

* **You'll see a confirmation dialog** telling you exactly **how many listings** will be removed, and **which manually managed lists** they sit in (if any), before anything is deleted.
* **Nothing is removed until you confirm.** Click **Cancel** to leave everything in place.
* **Nothing is lost permanently.** You can **restore** these listings at any time by re-enabling the scope and running a sync.

## Listing states from realestate.com.au

REA exposes sold, leased, and off-market states on its feed, but the feed is thinner than what CRMs publish. Voqo brings what REA provides into your Knowledge Base honestly, and tells you explicitly when a field isn't available.

### Sold listings

When you enable **Sold & off-market listings**, REA residential listings flipped to **sold** appear in the **Sold** tab with a red **Sold** badge.

Each sold listing carries:

* **Sold price** — REA's `<soldPrice>` value, when published.
* **Sold date** — REA's `<soldDate>` value.
* **Sale method** — shown as **Not provided** in the Knowledge Base. realestate.com.au's feed does not include the sale method (Auction, Private Treaty, Tender, etc.) on sold listings. Your AI agent will quote the price and date without claiming a method.
* **Price-display flag** — REA's feed does not include a vendor-confidentiality flag, so sold prices are always displayed when REA provides them.

<Note>
  **Limitation — REA sold feed is thinner than Domain or your CRM.** This is a data gap on REA's side, not a Voqo limitation. If you need sale-method context for your AI agent's sold-listings prompts, connect your CRM (Eagle MRI, AgentBox, or VaultRE) — CRMs publish the sale method on sold properties.
</Note>

### Leased listings

When you enable **Leased listings**, REA rental listings flipped to **leased** appear in the **For Lease** archive with a **Leased** badge.

Each leased listing carries:

* **Leased date** — falls back to the listing's last-modified time. REA's feed does not include a dedicated lease date.
* **Weekly rent** — **not available**. REA's feed does not include the rent on a leased rental.
* **Lease term (months)** — **not available**.
* **Lease end date** — **not available**.
* **Price-display flag** — derives from the rental's `<rent display="no">` attribute when present, otherwise defaults to display.

<Note>
  **Limitation — REA leased feed is thin.** realestate.com.au's feed exposes the leased status but not the lease term, end date, or weekly leased rent. If you need this detail for your AI agent's prompts, connect your CRM — CRMs publish the full tenancy detail on leased properties.
</Note>

### Off-market listings

REA listings flipped to **off-market** appear in the **Off-Market** tab with an **Off-Market** badge. Your AI agent prefixes these listings with **"OFF-MARKET —"** when speaking about them.

### Upcoming auctions

REA auction listings populate Voqo's **Upcoming Auctions** smart-list template. The auction date is pulled from REA's `<auctionDate>` element on the listing. Build a list under **Quick Create → Upcoming Auctions** and attach it to your AI agent so it can prepare for auction-week calls.

***

## Smart lists for realestate.com.au listings

In the Knowledge Base **Quick Create** menu, you can build per-state smart lists that include REA stock:

* **Sold Properties** — every sold listing (across all integrations); narrow to REA with the source filter
* **Leased Properties** — every leased rental
* **Upcoming Auctions** — every listing with an auction date in the next 14 days

<Note>
  **`Lease Properties` vs `Leased Properties`** — these are different lists. **Lease Properties** is your current rental stock available to lease. **Leased Properties** is the archive of rentals that have already been leased out. Pick the one that matches your use case.
</Note>

***

## Why your REA sold listings might look different from a Domain customer's

Different portals publish different fields on sold and leased listings. Voqo shows you the deepest detail your data source provides and is explicit when a field isn't available — rather than hiding the gap or filling it with a guess.

| Field                                    | realestate.com.au    | Domain                     |
| ---------------------------------------- | -------------------- | -------------------------- |
| Sold price                               | Yes (when published) | Yes                        |
| Sold date                                | Yes                  | Yes                        |
| Sale method (Auction, etc.)              | Not provided         | Yes                        |
| Settled price (post-titles registration) | Not provided         | Yes                        |
| Price-display flag                       | Always display       | Yes                        |
| Leased rent / term / end date            | Not provided         | n/a (Domain is sales-only) |

If you need richer sold or leased context for your AI agent, connect your CRM in addition to REA — CRM feeds (Eagle MRI, AgentBox, VaultRE) publish the full detail on sold and leased listings.

***

## Sync expectations

* **Initial sync** — imports your active listing data into the Knowledge Base.
* **Ongoing sync** — scheduled. The most recent state changes from REA (sold, leased, off-market flips) are picked up automatically.
* **Manual resync** — click **Sync now** on the realestate.com.au card if you want to pull updates between scheduled runs.

## Retry and recovery

* **Credential error** — re-check your agency details and reconnect.
* **Sync failure** — retry manual sync after credential validation.
* **Partial sync** — verify the source listing is published on realestate.com.au and run **Sync now**.

## Troubleshooting

| Issue                                                               | What to do                                                                                                                                                                                                              |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sold listings show "Sale method: Not provided"**                  | realestate.com.au's feed does not include the sale method. Sold price and sold date are accurate; method is unavailable from the source. If you need sale-method context, connect your CRM.                             |
| **A leased listing doesn't show weekly rent**                       | realestate.com.au's feed does not include rent on leased rentals. If you need this detail, connect your CRM.                                                                                                            |
| **A listing disappeared from For Sale but I can't find it in Sold** | Check the **Off-Market** tab. REA may have flipped the listing to off-market rather than sold.                                                                                                                          |
| **Sold listings haven't appeared yet**                              | Click **Sync now** on the REA card. Sold listings appear at the next scheduled sync if you wait.                                                                                                                        |
| **My sold or leased listings disappeared**                          | You may have turned off the matching scope, or an older listing rolled off your **Historical listing window**. Re-enable the scope (or widen the window) from the REA settings and run **Sync now** to bring them back. |
| **I want to keep more sold history**                                | Open the REA settings and set the **Historical listing window** to a longer period (up to **Last 24 months**), then run a sync.                                                                                         |

## Disconnect

1. Click **Disconnect** on the realestate.com.au card.
2. Confirm the action.

Disconnecting stops all future syncs. Previously synced listings remain in your workspace but are no longer linked to REA — the source badge disappears and scheduled syncs stop.

## Need help?

If anything's not working as expected, contact <a href="mailto:support@voqo.ai?subject=realestate.com.au%20integration%20help">support</a> with your workspace ID and the listing address.

## Related docs

* [Choose and Connect Integrations](overview-integration)
* [Knowledge Base Lists and Sources](knowledge-base-integrations)
* [Sold Listings in the Knowledge Base](../knowledge-base/sold-listings)
* [Leased Listings in the Knowledge Base](../knowledge-base/leased-listings)
