# CommercialRealEstate.com.au Sold, Lease Listing Finder (`crawlyth-forge/commercialrealestate-com-au-sold-lease-listing`) Actor

Search Australian commercial property listings by state and category across for-sale, for-lease, sold and business-for-sale, with price, address, agency and GPS details per listing.

- **URL**: https://apify.com/crawlyth-forge/commercialrealestate-com-au-sold-lease-listing.md
- **Developed by:** [crawlyth forge](https://apify.com/crawlyth-forge) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

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

## CommercialRealEstate.com.au Sold, Lease Listing Finder

[commercialrealestate.com.au](https://www.commercialrealestate.com.au) is Australia's commercial property portal, covering for-sale, for-lease, recently-sold and business-for-sale listings nationwide. This actor builds a search from your filters (listing type, state, property category, keyword) or scrapes specific listing URLs you already have.

### What this actor does

- Searches four listing types: for sale, for lease, recently sold, and business-for-sale
- Filters by one or more Australian states/territories and by commercial property category (offices, industrial/warehouse, retail, development land, and more)
- Supports a location slug for suburb/postcode-level searches and a free keyword search over listing titles and descriptions
- Accepts your own commercialrealestate.com.au URLs directly instead of building a search
- Omits any field a listing doesn't publish — no blank placeholder values

### Output per listing

- `adID` — unique numeric listing ID
- `url` — full listing detail page URL
- `headline` — listing title
- `description` — short property description
- `displayableAddress`, `street`, `suburb`, `state`, `postcode`, `region`, `area` (local government area)
- `price` — price text as published (e.g. `$1,200,000` or `Contact Agent`)
- `saleType` — listing type label (For Sale, Leased, Sold, etc.)
- `saleMethod` — sale method (Auction, EOI, Private Treaty)
- `listingStatus` — status flag (New, Updated)
- `soldLeasedDate`, `soldLeasedPricing` — when and at what price the property sold or leased, if disclosed
- `auctionDate`, `auctionTime`
- `areaDisplay` — property area as displayed (e.g. `994 m²`)
- `mainCategory`, `propertyTypes` — primary and full property type labels
- `isUnderOffer`, `hasVideo`, `hasVirtualTour` — booleans
- `cardImageUrl`, `images[]`
- `agencyName`, `agencyLogoUrl`, `agents[]` (each with `name`, `photo`)
- `latitude`, `longitude`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | select | `search` | `search` (build from filters) or `startUrls` (scrape your own URLs) |
| `listingMode` | select | `sold` | `for-sale`, `for-lease`, `sold`, or `business` |
| `states` | array | – | One or more of NSW, VIC, QLD, SA, WA, TAS, ACT, NT; empty = all of Australia |
| `propertyType` | select | – | Commercial property category; not applicable to `business` listings |
| `locationSlug` | string | – | A specific location slug from a CRE URL (e.g. `sydney-nsw`, `melbourne-vic-3000`); overrides `states` |
| `keyword` | string | – | Keyword to match in listing titles/descriptions (e.g. `warehouse`, `childcare`) |
| `startUrls` | array | – | commercialrealestate.com.au URLs to scrape directly, used with `mode=startUrls` |
| `maxItems` | integer | `20` | Maximum listings to return (each search URL returns up to 20) |
| `proxyConfiguration` | object | – | Apify proxy settings; see the notes below on when this matters |

#### Example: sold offices in New South Wales

```json
{
  "mode": "search",
  "listingMode": "sold",
  "states": ["NSW"],
  "propertyType": "offices",
  "maxItems": 20
}
```

#### Example: for-lease warehouses nationwide, with an Australian proxy

```json
{
  "mode": "search",
  "listingMode": "for-lease",
  "propertyType": "industrial-warehouse",
  "maxItems": 20,
  "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["AUTO"], "apifyProxyCountry": "AU"}
}
```

#### Example: scrape specific listing URLs

```json
{
  "mode": "startUrls",
  "startUrls": [
    {"url": "https://www.commercialrealestate.com.au/sold/sydney-nsw/offices/"}
  ],
  "maxItems": 20
}
```

### Use cases

- **Investment research** — track recently sold commercial property prices by state and category
- **Site selection** — search for-lease warehouse or retail space in a target area
- **Business brokerage** — monitor new business-for-sale listings by keyword
- **Agency benchmarking** — compare listing volumes and pricing across agencies in a region

### FAQ

**Is this affiliated with commercialrealestate.com.au?** No. This is an independent tool that reads commercialrealestate.com.au's public listing pages; it is not operated by or affiliated with the site.

**Why do I only get up to around 20 results per search?** Each search URL is rendered by the site with a fixed page of 20 listings, and the site doesn't expose a working page/offset parameter that returns a different page of the same filter combination. To see more, select multiple `states` (each state is its own search) or narrow with a `locationSlug` for a different result set.

**Can I combine `locationSlug` with `states` or `propertyType`?** No — `locationSlug` is a single resolved path segment on the site, and the site's own router drops other filters when one follows a location slug. Use `locationSlug` on its own for suburb/postcode-level searches.

**Does `propertyType` apply to business listings?** No. Business-for-sale listings use a separate, unexposed category taxonomy (e.g. "Food, Beverage & Hospitality") rather than the commercial property types.

**Why did my for-sale, for-lease or business search return 0 results?** Those three listing types sit behind bot protection that can block by IP reputation rather than just geography, so even an Australian-flagged proxy IP can occasionally be blocked. Try again, or supply your own residential proxy via `proxyConfiguration`. `sold` listings are unaffected and work reliably without a proxy.

**Why does a listing's `url` return a 403 when I fetch it directly with a script?** The same bot protection that affects for-sale/for-lease/business searches also protects individual listing pages against non-browser requests. The link opens normally in a regular browser; this is expected and not a broken link.

**How current is the data?** Every run fetches listings live from commercialrealestate.com.au at scrape time; nothing is cached between runs.

**Do I need a login?** No. All listing data is publicly accessible without an account.

# Actor input Schema

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

Choose how to find listings: build a search from filters, or provide specific URLs.

## `listingMode` (type: `string`):

Which type of listings to scrape (used in Search mode).

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

Limit results to one or more Australian states/territories (used in Search mode). Leave empty for all of Australia.

## `propertyType` (type: `string`):

Filter by commercial property category (used in Search mode). Leave empty for all types.

## `locationSlug` (type: `string`):

Specific location slug from a CRE URL, e.g. 'sydney-nsw', 'melbourne-vic-3000', or 'brisbane-qld'. Overrides States filter.

## `keyword` (type: `string`):

Keyword to search for in listing titles and descriptions, e.g. 'warehouse', 'childcare', 'petrol station'.

## `startUrls` (type: `array`):

List of commercialrealestate.com.au URLs to scrape (used in Start URLs mode). Can be search result pages, individual property pages, agent profiles, or agency pages.

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

Maximum number of listings to return. Each search URL returns up to 20 listings.

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

Apify proxy settings. Recommended for for-sale, for-lease, and business listing types — commercialrealestate.com.au's Akamai bot protection blocks most non-Australian and datacenter IPs on those paths, so results are not guaranteed even with proxy enabled. Not needed for sold listings, which work reliably with no proxy. Left empty by default so the default (sold) run has zero proxy dependency.

## Actor input object example

```json
{
  "mode": "search",
  "listingMode": "sold",
  "startUrls": [
    {
      "url": "https://www.commercialrealestate.com.au/sold/nsw/offices/"
    }
  ],
  "maxItems": 20
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset containing all scraped commercial property listings.

# 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 = {
    "mode": "search",
    "listingMode": "sold",
    "startUrls": [
        {
            "url": "https://www.commercialrealestate.com.au/sold/nsw/offices/"
        }
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlyth-forge/commercialrealestate-com-au-sold-lease-listing").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 = {
    "mode": "search",
    "listingMode": "sold",
    "startUrls": [{ "url": "https://www.commercialrealestate.com.au/sold/nsw/offices/" }],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlyth-forge/commercialrealestate-com-au-sold-lease-listing").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 '{
  "mode": "search",
  "listingMode": "sold",
  "startUrls": [
    {
      "url": "https://www.commercialrealestate.com.au/sold/nsw/offices/"
    }
  ],
  "maxItems": 20
}' |
apify call crawlyth-forge/commercialrealestate-com-au-sold-lease-listing --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlyth-forge/commercialrealestate-com-au-sold-lease-listing"
        }
    }
}
```

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/YLWRXYv2n5auhfbNh/builds/Vn2vkRItn5rNMDpO5/openapi.json
