# Cowdy  Properties Rent List (`getdataforme/cowdy-properties-rent-list`) Actor

This Apify actor efficiently scrapes comprehensive rental property listings from Cowdy.co.nz, extracting details like bedrooms, bathrooms, descriptions, and agent contacts....

- **URL**: https://apify.com/getdataforme/cowdy-properties-rent-list.md
- **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community)
- **Categories:** Real estate, AI, Other
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## 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

## Cowdy Properties Rent List

### Introduction

The Cowdy Properties Rent List Actor is a powerful web scraping tool designed to extract detailed rental property listings from Cowdy.co.nz, a leading real estate website in Christchurch, New Zealand. It automates the collection of comprehensive property data, including descriptions, specifications, and agent information, enabling users to gather insights efficiently without manual browsing. This Actor is ideal for real estate professionals, investors, and researchers seeking structured data for market analysis and decision-making.

### Features

- **Comprehensive Data Extraction**: Scrapes key property details such as title, bedrooms, bathrooms, parking, floor area, and full descriptions.
- **Agent Information**: Captures agent profiles, including names, roles, phone numbers, and profile links for direct contact.
- **Structured JSON Output**: Delivers clean, machine-readable data in JSON format, perfect for integration with databases or analytics tools.
- **Reliable and Fast**: Built on PlaywrightCrawler for robust handling of dynamic web content, ensuring high success rates and quick execution.
- **Customizable Start URLs**: Allows users to specify starting URLs for targeted scraping of specific property searches or regions.
- **Error-Resilient**: Includes built-in handling for common web scraping challenges like timeouts and anti-bot measures.
- **Apify Integration**: Seamlessly runs on the Apify platform with easy monitoring, scheduling, and export options.

### Input Parameters

| Parameter | Type | Required | Description | Example |
|-----------|------|----------|-------------|---------|
| startUrls | array | Yes | An array of URLs to start the scraping process. These should point to Cowdy.co.nz property search or listing pages. | \[{"url": "https://cowdy.co.nz/christchurch-rental-properties/search-properties/"}] |

### Example Usage

To run the Actor, provide the input in JSON format:

```json
{
  "startUrls": [
    {
      "url": "https://cowdy.co.nz/christchurch-rental-properties/search-properties/"
    }
  ]
}
```

Example output in JSON format:

```json
[
  {
    "url": "https://cowdy.co.nz/property/40-clare-road-merivale-3/",
    "page_title": "40 Clare Road, Merivale | Cowdy Real Estate",
    "product_title": "As New Executive 3-Bedroom Townhouse in Merivale",
    "bedrooms": "3",
    "bathrooms": "2",
    "parking": "1",
    "floor_area": "",
    "description": "Available Now\n\n\u2013 Bedrooms: 3 Doubles \u2013 Heating: Heat Pump & Electric Heater \u2013 Parking: Single Garage \u2013 Pets: Consent on application\n\nTo make an appointment to attend a viewing you must register online by clicking the \u2018Book a Viewing\u2019 button. If you are using TradeMe please copy & paste the following link into the browser address bar and click the \u2018Book a Viewing\u2019 button on our site \u2013 https://tinyurl.com/28v7m8kx\n\nPLEASE NOTE: APPOINTMENTS ARE ESSENTIAL OR VIEWINGS MAY BE CANCELLED\n\nVIEWING APPOINTMENTS: THURSDAY 15TH JANUARY 4.30 PM \u2013 4.45 PM FRIDAY 16TH JANUARY 12.30 PM \u2013 12.45 PM\n\nUnfurnished architecturally designed with a single garage townhouse by PRAU- Phil Redmond Architecture: Open plan kitchen /living room with bi-fold doors opening onto a private north-facing courtyard. The kitchen has stone bench tops and premium Fisher & Paykel appliances. Three double bedrooms upstairs, master with ensuite plus main bathroom. Both bathrooms have under-tile heating and a separate toilet. Located just minutes to Merivale, Victoria Street Precinct, Hagley Park & the Central City. The laundry in the single garage has internal access. Zoned for Christchurch Girls\u2019 and Boys\u2019 High Schools, Burnside High, and Heaton & Elmwood\n\nRent: $800 + Bond: $3200 = $4000\n\nAvailable Now \u2013 Contact Janice\n\nTo book an appointment to view, please click the button below & fill in the registration.",
    "agents": [
      {
        "name": "Janice Cowdy",
        "role": "Director",
        "phone": "021 365 607",
        "profile": "https://cowdy.co.nz/agent/janice-cowdy/",
        "image": "https://cowdy.co.nz/wp-content/uploads/2023/10/JaniceCowdy_Featured_400x260.jpg"
      }
    ]
  }
]
```

### Use Cases

- **Market Research and Analysis**: Gather data on rental trends, pricing, and property features to inform investment decisions.
- **Competitive Intelligence**: Monitor competitors' listings and agent activities in the Christchurch real estate market.
- **Price Monitoring**: Track rental prices and availability for specific neighborhoods or property types.
- **Content Aggregation**: Build databases of property descriptions and images for real estate websites or apps.
- **Academic Research**: Collect data for studies on housing markets, urban development, or economic indicators.
- **Business Automation**: Automate lead generation by extracting agent contacts for outreach and networking.

### Installation and Usage

1. Search for "Cowdy Properties Rent List" in the Apify Store
2. Click "Try for free" or "Run"
3. Configure input parameters
4. Click "Start" to begin extraction
5. Monitor progress in the log
6. Export results in your preferred format (JSON, CSV, Excel)

### Output Format

The Actor outputs data in JSON format as an array of objects, each representing a property listing. Key fields include:

- `url`: The direct link to the property page.
- `page_title`: The title of the webpage.
- `product_title`: The property's headline title.
- `bedrooms`, `bathrooms`, `parking`, `floor_area`: Numeric or descriptive specifications.
- `description`: Full text description of the property, including rent details and viewing info.
- `agents`: An array of agent objects with name, role, phone, profile URL, and image URL.

This structured format ensures easy parsing and integration.

### Support

For custom/simplified outputs or bug reports, please contact:

- Email: support@getdataforme.com
- Subject line: "custom support"
- Contact form: https://getdataforme.com/contact/

We're here to help you get the most out of this Actor!

# Actor input Schema

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

URLs to start with.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://cowdy.co.nz/christchurch-rental-properties/search-properties/"
    }
  ]
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://cowdy.co.nz/christchurch-rental-properties/search-properties/"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/cowdy-properties-rent-list").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 = { "startUrls": [{ "url": "https://cowdy.co.nz/christchurch-rental-properties/search-properties/" }] }

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/cowdy-properties-rent-list").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 '{
  "startUrls": [
    {
      "url": "https://cowdy.co.nz/christchurch-rental-properties/search-properties/"
    }
  ]
}' |
apify call getdataforme/cowdy-properties-rent-list --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getdataforme/cowdy-properties-rent-list"
        }
    }
}

```

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/D4kwV4F9fAk6jKSFZ/builds/v0PCVSUIqESiAeh2r/openapi.json