# Propertypal Scraper (`dhrumil/propertypal-scraper`) Actor

Scrape propertypal.com to crawl millions of sale/rent real estate properties from Northern Ireland. Our real estate scraper also lets you monitor specific listing for new updates/listing. You can provide multiple search result listings to scrape/monitor.

- **URL**: https://apify.com/dhrumil/propertypal-scraper.md
- **Developed by:** [Dhrumil Bhankhar](https://apify.com/dhrumil) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 6 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$20.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

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

### 🏡 What is Propertypal Real Estate Properties Scraper?

This Propertypal properties Scraper will enable you scrape any sale/rent listing from  collection from [propertypal.co.uk/](https://www.propertypal.co.uk/).

You can simply take your listing url from browser and enter it into this actor. This actor will crawl through all pages of particular listing and generate dataset for you.

Listing url is something you get when you perform the search on propertypal site. Example listing urls :

- https://www.propertypal.com/search?sta=forSale\&sta=saleAgreed\&st=sale\&pt=residential\&max=40000\&currency=GBP\&term=3
- https://www.propertypal.com/search?sta=toLet\&sta=letAgreed\&st=rent\&pt=residential\&currency=GBP\&term=3

### 🚪 What can this Propertypal Scraper do?

📈 Extract Propertypal market data listings on Propertypal

👀 This actor is not just scraper but also has monitoring capability. You can turn on monitoring mode and it will give you only newly added properties compared to your previous scrapes.

📩  This actor also helps yu to identify which properties are not listed anymore. Please refer to [Identifying delisted properties](#identifying-delisted-properties)

⬇️ Download Propertypal real estate data in Excel, CSV, JSON, and other formats

### 📚 How do I start scraping with this scraper?

1. Register for your free Apify account [here](https://apify.com/pricing?fpr=z2di7)
2. You don't need to provide your credit card details for free acount. Just click on "Get Started" button on above link and complete the registration only.
3. Free account comes with reasonable credits to try out this actor. This actor also comes with free trial of 1 hour without any commitment/upfront charge.
4. Run this actor and verify the scraped data. Apify has huge integration possibilities. You can download the data or push the data into any 3rd party platform directly.

### 🌳 What Propertypal data can I extract using this tool?

|       📝         |             📝            |
|------------------|----------------------------|
| Field                | Description                        |
|----------------------|------------------------------------|
| id                   | Property ID                        |
| url                  | Listing URL                        |
| title                | Listing Title                      |
| address              | Full Address                       |
| street               | Street Name                        |
| town                 | Town/City                          |
| nameOrNumber         | Name or Number                     |
| addressLine1         | Address Line 1                     |
| addressLine2         | Address Line 2                     |
| bedrooms             | Number of Bedrooms                 |
| bathrooms            | Number of Bathrooms                |
| receptionrooms       | Number of Reception Rooms           |
| pricePrefix          | Price Prefix (e.g., Offers Over)   |
| price                | Price                              |
| priceMin             | Minimum Price                      |
| priceMax             | Maximum Price                      |
| status               | Listing Status                     |
| region               | Region/County                      |
| description          | Description (HTML)                 |
| coordinates          | Coordinates (lat/lng, etc.)        |
| epcRating            | EPC Rating                         |
| incode               | Incode (postcode part)             |
| outcode              | Outcode (postcode part)            |
| heatingType          | Heating Type                       |
| history              | Price/Status History               |
| category             | Category (e.g., Added)             |
| listingUpdatedTime   | Last Updated Time                  |
| type                 | Type (object: key/text)            |
| postalCode           | Postal Code                        |
| propertyType         | Property Type                      |
| listingsCategory     | Listings Category                  |
| account              | Agent/Account Info (object)        |
| publishedOn          | Published On Date                  |
| images               | Image URLs                         |
| agents               | Agents (array of objects)          |
| berExempt            | BER Exempt (boolean)               |
| broadbandSpeed       | Broadband Speed Info (object)      |
| brochures            | Brochures (array of objects)       |
| brokers              | Brokers (array)                    |
| coOwnershipEligible  | Co-Ownership Eligible (boolean)    |
| coOwnershipOnly      | Co-Ownership Only (boolean)        |
| dateAvailableFrom    | Date Available From                |
| dateViewableFrom     | Date Viewable From                 |
| features             | Features (array)                   |
| premiumListing       | Premium Listing (boolean)          |
| priceTrackerAvailable| Price Tracker Available (boolean)  |

### ⬇️ Input

For simple use, provide the browser URL of a Propertypal search result page. Other fields have sensible defaults but can be customized as needed.

#### Input example

```json
{
	"listUrls": [
		{
			"url": "https://propertypal.com/search?sta=forSale&sta=saleAgreed&st=sale&pt=residential&max=40000&currency=GBP&term=3"
		}
	],
	"monitoringMode": false,
	"fullPropertyDetails": true,
	"addEmptyTrackerRecord": false,
	"enableDelistingTracker": false,
	"email": "",
	"proxy": {
		"useApifyProxy": true,
		"apifyProxyGroups": ["RESIDENTIAL"],
		"apifyProxyCountry": "GB"
	}
}
```

##### Input fields

- `listUrls` (array): Propertypal sale or rent listing URLs to scrape.
- `monitoringMode` (boolean): If true, only newly listed properties compared to previous runs will be scraped.
- `fullPropertyDetails` (boolean): If true, scrapes each property for full details. Turn off for faster, basic scraping.
- `addEmptyTrackerRecord` (boolean): If true, adds tracker ID record in incremental mode to help identify delisted properties with a custom loader.
- `enableDelistingTracker` (boolean): If true, tracks every property with a date in KV Store to help find delisted properties. May impact billing.
- `email` (string): Email address for notifications or error reports.
- `proxy` (object): Proxy configuration. Defaults to Apify residential proxy for the UK.

### ⬆️ Output

Scraped data is stored in the dataset for each run. You can view or download results in JSON, CSV, Excel, XML, RSS, and HTML formats.

#### Output example

```json
{
	"id": "1051111",
	"url": "https://www.propertypal.com/25-hopefield-avenue-portrush/1052311",
	"title": "4 Bed Detached House",
	"address": "25 Hopefield Avenue, Portrush, BT56 8HB",
	"street": "Hopefield Avenue",
	"town": "Portrush",
	"nameOrNumber": "25",
	"addressLine1": "25 Hopefield Avenue",
	"bedrooms": 4,
	"bathrooms": 2,
	"receptionrooms": 1,
	"pricePrefix": "Offers Over",
	"status": "For sale",
	"region": "Antrim",
	"price": 395000,
	"description": "<h2>Additional Information</h2><ul>\n  <li>Detached House</li>\n  <li>Four Bedroom</li>\n  <li>Garage</li>\n  <li>Large Garden</li>\n  <li>Oil Central Heating</li>\n  <li>Private Driveway</li>\n  <li>uPVC Windows &amp; Doors</li>\n</ul>",
	"coordinates": {
		"latitude": 55.1979,
		"longitude": -6.65297,
		"accuracy": "unsure",
		"mapZoomLevel": 10,
		"showStreetView": true
	},
	"epcRating": "E46/E54",
	"priceMin": 395000,
	"priceMax": null,
	"incode": "8HB",
	"outcode": "BT56",
	"heatingType": "Oil",
	"history": [
		{
			"difference": null,
			"priceOnApplication": false,
			"publishedOnAwp": true,
			"published": true,
			"timeModified": "2025-12-30T15:22:35+0000",
			"price": 395000,
			"status": {
				"key": "forSale",
				"text": "For sale"
			},
			"previousStatus": null,
			"previousPrice": null,
			"previousPublished": false,
			"statusChange": true,
			"priceChange": false,
			"publishedChange": true,
			"publishedOnAwpChange": true,
			"differencePercentage": null,
			"pricePrefix": "Offers Over",
			"priceSuffix": null
		}
	],
	"category": "Added",
	"listingUpdatedTime": "2025-12-30T16:33:10+0000",
	"type": {
		"key": "residential",
		"text": "Residential"
	},
	"postalCode": "BT56 8HB",
	"propertyType": "Detached Houses",
	"listingsCategory": "Residential",
	"account": {
		"accountNumber": "ST1012202",
		"organisation": "Causeway Coast Sales & Rentals",
		"organisationBranch": "",
		"displayAddress": "1 Harbour Place, Portstewart, BT55 7AX",
		"officePhone": {
			"countryCode": 44,
			"displayNumber": "+44 28 7083 2220",
			"international": "+44 28 7083 2220",
			"national": "028 7083 2220",
			"uk": "028 7083 2220"
		},
		"psrLicenceNumber": null,
		"websiteUrl": "https://www.causewaycoastrentals.co.uk",
		"landingPageUrl": "/estate-agents/causeway-coast-sales-rentals",
		"groupLandingPageUrl": null,
		"privateDeveloper": false,
		"developerPrimaryContact": false,
		"developer": false,
		"agent": true,
		"featuredAgent": false,
		"detailsEnabled": true,
		"emailEnabled": true,
		"showAddress": true,
		"hasMicrosite": true,
		"includeFeeCharges": true,
		"logo": {
			"standard": "https://media.propertypal.com/logo/160816205354/400x400/ST1012202/sales.png"
		},
		"agentLogos": [
			{
				"logoType": "STANDARD",
				"url": "https://media.propertypal.com/logo/160816205354/400x400/ST1012202/sales.png",
				"width": 600,
				"height": 256,
				"backgroundColour": "#b5251c",
				"accountNumber": "ST1012202",
				"developer": false,
				"agent": true
			}
		],
		"accreditations": [
			{
				"id": 2,
				"label": "TPOS",
				"textKey": "propertyOmbudsman",
				"url": "https://www.tpos.co.uk/",
				"imageUrl": "https://www.propertypal.com/accreditations/propertyOmbudsman.png",
				"type": "ESSENTIAL",
				"tooltip": "Free, impartial and independent Ombudsman service, resolving disputes between Consumers and Property Agents since 1990."
			}
		],
		"missingAccreditations": null,
		"propertypalAwards": [],
		"openingTimes": [
			{
				"openTime": "2019-12-30T09:00:00+0000",
				"closeTime": "2019-12-30T17:30:00+0000",
				"byAppointment": false,
				"closed": false,
				"lunchBreak": false
			}
		],
		"tier": "CUSTOM",
		"enhancedBranding": false,
		"searchUrl": "/search?radius=5.0&runit=m&rlat=55.1979&rlng=-6.65297&sta=forSale&st=sale&pt=residential&min=300000&max=450000&currency=GBP&term=397432"
	},
	"publishedOn": "2025-12-30T15:22:35+0000",
	"images": [
		"https://media.propertypal.com/large/p/1051111/39832548.jpg",
		"https://media.propertypal.com/large/p/1051111/39832545.jpg"
	],
	"addressLine2": "",
	"agents": [
		{
			"accountNumber": "ST1012202",
			"organisation": "Causeway Coast Sales & Rentals",
			"organisationBranch": "",
			"displayAddress": "1 Harbour Place, Portstewart, BT55 7AX",
			"officePhone": {
				"countryCode": 44,
				"displayNumber": "+44 28 7083 2220",
				"international": "+44 28 7083 2220",
				"national": "028 7083 2220",
				"uk": "028 7083 2220"
			},
			"psrLicenceNumber": null,
			"websiteUrl": "https://www.causewaycoastrentals.co.uk",
			"landingPageUrl": "/estate-agents/causeway-coast-sales-rentals",
			"groupLandingPageUrl": null,
			"privateDeveloper": false,
			"developerPrimaryContact": false,
			"developer": false,
			"agent": true,
			"featuredAgent": false,
			"detailsEnabled": true,
			"emailEnabled": true,
			"showAddress": true,
			"hasMicrosite": true,
			"includeFeeCharges": true,
			"logo": {
				"standard": "https://media.propertypal.com/logo/160816205354/400x400/ST1012202/sales.png"
			},
			"agentLogos": [
				{
					"logoType": "STANDARD",
					"url": "https://media.propertypal.com/logo/160816205354/400x400/ST1012202/sales.png",
					"width": 600,
					"height": 256,
					"backgroundColour": "#b5251c",
					"accountNumber": "ST1012202",
					"developer": false,
					"agent": true
				}
			],
			"accreditations": [
				{
					"id": 2,
					"label": "TPOS",
					"textKey": "propertyOmbudsman",
					"url": "https://www.tpos.co.uk/",
					"imageUrl": "https://www.propertypal.com/accreditations/propertyOmbudsman.png",
					"type": "ESSENTIAL",
					"tooltip": "Free, impartial and independent Ombudsman service, resolving disputes between Consumers and Property Agents since 1990."
				}
			],
			"missingAccreditations": null,
			"propertypalAwards": [],
			"openingTimes": [
				{
					"openTime": "2019-12-30T09:00:00+0000",
					"closeTime": "2019-12-30T17:30:00+0000",
					"byAppointment": false,
					"closed": false,
					"lunchBreak": false
				}
			],
			"tier": "CUSTOM",
			"enhancedBranding": false,
			"searchUrl": "/search?radius=5.0&runit=m&rlat=55.1979&rlng=-6.65297&sta=forSale&st=sale&pt=residential&min=300000&max=450000&currency=GBP&term=397432",
		}
	],
	"berExempt": false,
	"broadbandSpeed": {
		"estimated": false,
		"timeLastCached": "2025-12-30T15:22:36+0000",
		"maxPredictedDown": "900",
		"maxPredictedUp": "110",
		"maxBbPredictedDown": "17",
		"maxBbPredictedUp": "1",
		"maxSfbbPredictedDown": "76",
		"maxSfbbPredictedUp": "17",
		"maxUfbbPredictedDown": "900",
		"maxUfbbPredictedUp": "110",
		"maxFibrusDown": "982",
		"maxFibrusUp": "310",
		"fibrusAvailable": true
	},
	"brochures": [
		{
			"sizeDescription": "510.3KB",
			"title": "Brochure",
			"publicFilename": "Brochure.pdf-3310363.pdf",
			"contentType": "application/pdf",
			"fileType": "pdfBrochure",
			"displayOrder": 36,
			"url": "https://media.propertypal.com/f/p/1051111/3310363/Brochure.pdf"
		}
	],
	"brokers": [],
	"coOwnershipEligible": false,
	"coOwnershipOnly": false,
	"dateAvailableFrom": null,
	"dateViewableFrom": null,
	"features": [
		"Status : For sale",
		"Style : Detached House",
		"Bedrooms : 4",
		"Bathrooms : 2",
		"Receptions : 1",
		"Tenure : Freehold",
		"EPC Rating : E46/E54",
		"Heating : Oil",
		"Broadband : Highest download speed: 900 Mbps Highest upload speed: 110 Mbps",
		"Price : Offers Over £395,000",
		"Stamp Duty : null",
		"Rates : £1,841.40 pa",
		"Views All Time : 2299"
	],
	"premiumListing": false,
	"priceTrackerAvailable": true
}
```

### ❓Limitations

Since Propertypal allows only 3000 properties per listing/search result, you might want to break down your listing urls into smaller area if it has more than 1K results. Good News is that even if multiple list urls contains overlapping results, they will get deduplicated within same run data.

This actor has ability to bypass captcha. However, please run this actor with residential proxy with country United Kingdom to get results smoothly.

### 🤝 Related Actors

- [Rightmove Scraper](https://apify.com/dhrumil/rightmove-scraper?fpr=z2di7): Scrape sale/rent listings from rightmove.co.uk.
- [Zoopla Scraper](https://apify.com/dhrumil/zoopla-scraper?fpr=z2di7): Scrape sale/rent listings from zoopla.co.uk.
- [OnTheMarket Scraper](https://apify.com/dhrumil/onthemarket-scraper?fpr=z2di7) : Scrape property sale/rent listings, prices, and details from OnTheMarket.
- [Rightmove Full Address & House Number Finder](https://apify.com/dhrumil/rightmove-full-address-house-number-finder?fpr=z2di7): Find full addresses and house numbers for Rightmove listings.
- [Rightmove Land Registry Full Address & House Number Finder](https://apify.com/dhrumil/rightmove-landregistry-full-address-house-number-finder?fpr=z2di7): Get full address and house number using Land Registry data for Rightmove properties.
- [Rightmove EPC Full Address Finder](https://apify.com/dhrumil/rightmove-epc-full-address-finder?fpr=z2di7): Find EPC and full address details for Rightmove listings.
- [Rightmove Commercial Scraper](https://apify.com/dhrumil/rightmove-commercial-scraper?fpr=z2di7): Scrape commercial property listings from Rightmove.
- [Rightmove Sold House Properties Scraper](https://apify.com/dhrumil/rightmove-sold-house-properties-scraper?fpr=z2di7): Scrape sold house price data from Rightmove.
- [Rightmove Agents Scraper](https://apify.com/dhrumil/rightmove-agents-scraper?fpr=z2di7): Extract agent and agency details from Rightmove.
- [Propertypal Sold Properties Scraper](https://apify.com/dhrumil/propertypal-sold-properties-scraper?fpr=z2di7): Scrape sold property data from Propertypal.
- [Propertypal Commercial Properties Scraper](https://apify.com/dhrumil/propertypal-commercial-properties-scraper?fpr=z2di7): Scrape commercial property listings from Propertypal.

### 🔎 Identifying delisted properties

This actor provides you monitoring mode configuration using which you can get only incremental updates about newly added properties. In case, you also want to identify which properties are delisted from platform, you can use any of the following techniques with the help of this actor.

1. Running Always in full scraper mode :
   Run this actor always in full scrape mode and cross check the new incoming batch of data with your existing database. If any property that exists in yoru database but not in newly scraped data batch, that means it's not listed anymore

2. Use Key Value Store generated by scraper :
   If your are monitoring very large batch of data and you don't want to scrape everything all the time, this method involves bit of technicality but achieves the goal efectively. Apify has storage feature called [Key-value store](https://docs.apify.com/api/v2/#/reference/key-value-stores/key-collection/get-list-of-keys). When you run this scrape, this scraper stores every single property in key value store along with timestamp in `propertypal-properties` store. Inside this store, key is property id itself and value is timestamp like this

   ```
   { lastSeen : '2023-11-02T05:59:25.763Z'}
   ```

   Whenever you run this scraper, it will update the timestamp against particular id if it finds property on the platform. e.g. if we have 2 proprties with id `prop1` and `prop2` and we scraped them both on November 1, key value storage would look like this :

   ```
   prop1 -> { lastSeen : '2023-11-01T05:59:25.763Z'}
   prop2 -> { lastSeen : '2023-11-01T05:59:25.763Z'}
   ```

   Now if you run this scraper again on December 1 and prop1 is not on the platform anymore but prop2 is still there, key value storage would change like this :

   ```
   prop1 -> { lastSeen : '2023-11-01T05:59:25.763Z'}
   prop2 -> { lastSeen : '2023-12-01T05:59:25.763Z'}
   ```

   That means if any property has `lastSeen` less than latest batch you loaded, that property is delisted now. You can directly iterate through whole Key value storage using Apify key value storage API to identify this. Please refer to [this](https://docs.apify.com/api/v2/#/reference/key-value-stores/key-collection/get-list-of-keys) API documentation to do the same. Please remember store name generated by this scrape will be `propertypal-properties`.

   Alternatively, you can iterate through your existing database active properties and use [this](https://docs.apify.com/api/v2/#/reference/key-value-stores/record/get-record) API to identify listing status.

   For this approach to work, it's important that you enable this feature via `enableDelistingTracker` (Enable Delisting tracker) input.

### 🙋‍♀️ For custom solutions

In case you need some custom solution, you can contact me : <dhrumil@techvasu.com>

Or learn more about me on github : <https://github.com/dhrumil4u360>

# Actor input Schema

## `listUrls` (type: `array`):

Any propertypal sale or rent property listing url which has list of properties

## `monitoringMode` (type: `boolean`):

If checked, it will only scrape newly listed properties compared to what has been scraped in previous runs. Please turn off full scrape setting above in case you are tunring this on.

## `fullPropertyDetails` (type: `boolean`):

If checked, it will scrape each individual property to get more details about property. If you need only limited information, turning off this option would scrape a lot more faster.

## `addEmptyTrackerRecord` (type: `boolean`):

If checked, it will add tracker ID record in incremental mode so that you can identify delisted properties if you have custom loader

## `enableDelistingTracker` (type: `boolean`):

If checked, it will track every single property with date so that you can find out which property is delisted. ( Enabling this has impact on billing )

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

Email address to send notifications or reports to.

## `maxPages` (type: `integer`):

Limits the number of pages to enqueue and scrape. Leave empty or 0 for no limit.

## `proxy` (type: `object`):

Select proxies to be used by your crawler.

## Actor input object example

```json
{
  "listUrls": [
    {
      "url": "https://www.propertypal.com/search?sta=forSale&sta=saleAgreed&st=sale&pt=residential&max=40000&currency=GBP&term=3"
    }
  ],
  "monitoringMode": false,
  "fullPropertyDetails": true,
  "addEmptyTrackerRecord": false,
  "enableDelistingTracker": false,
  "email": "",
  "maxPages": 0,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GB"
  }
}
```

# 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 = {
    "listUrls": [
        {
            "url": "https://www.propertypal.com/search?sta=forSale&sta=saleAgreed&st=sale&pt=residential&max=40000&currency=GBP&term=3"
        }
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "GB"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("dhrumil/propertypal-scraper").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 = {
    "listUrls": [{ "url": "https://www.propertypal.com/search?sta=forSale&sta=saleAgreed&st=sale&pt=residential&max=40000&currency=GBP&term=3" }],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "GB",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("dhrumil/propertypal-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "listUrls": [
    {
      "url": "https://www.propertypal.com/search?sta=forSale&sta=saleAgreed&st=sale&pt=residential&max=40000&currency=GBP&term=3"
    }
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GB"
  }
}' |
apify call dhrumil/propertypal-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=dhrumil/propertypal-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/QgZ8fqCLYzV6zwMKq/builds/Kjy3ZmICWRd5rn7Vy/openapi.json