# Zoopla Properties Search Scraper (`powerai/zoopla-properties-search-scraper`) Actor

Search and scrape property listings from Zoopla with advanced filtering options using our API service

- **URL**: https://apify.com/powerai/zoopla-properties-search-scraper.md
- **Developed by:** [PowerAI](https://apify.com/powerai) (community)
- **Categories:** Real estate, Integrations, Lead generation
- **Stats:** 31 total users, 1 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.99 / 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?

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

## Zoopla Properties Search Scraper

This actor searches for properties on Zoopla using our API wrapper service to find real estate listings based on various criteria.

### Features

- **Comprehensive Property Search**: Search properties by location, price, bedrooms, and more
- **Advanced Filtering**: Filter by property type, furnished state, features, and availability
- **Real-time Results**: Get instant property listings from Zoopla
- **API Integration**: Uses our secure API wrapper service
- **Error Handling**: Comprehensive error handling and logging
- **Flexible Search**: Support for both sale and rental properties
- **Automatic Pagination**: Automatically fetches multiple pages to reach the requested number of results

### Input

The actor accepts the following input parameters:

#### Required Parameters

- **locationValue** (required): The location value to search for properties (e.g., 'London', 'Manchester')
- **locationIdentifier** (required): The location identifier for the search area

#### Optional Parameters

- **maxResults**: Maximum number of properties to fetch
- **category**: Property category (residential/commercial)
- **section**: Property section (for-sale/to-rent)
- **bedsMin/bedsMax**: Minimum and maximum number of bedrooms
- **priceMin/priceMax**: Minimum and maximum property price
- **sortOrder**: Sort order for results (newest_listings, highest_price, lowest_price, most_reduced)
- **radius**: Search radius in miles
- **keywords**: Keywords to search for in property descriptions
- **furnishedState**: Furnished state filter (Any, furnished, part_furnished, unfurnished)
- **includeRented/includeSold**: Include rented or sold properties
- **isAuction**: Show only auction properties
- **petsAllowed**: Show only properties that allow pets
- **billsIncluded**: Show only properties with bills included
- **chainFree**: Show only chain-free properties
- **reducedPriceOnly**: Show only properties with reduced prices
- **priceFrequency**: Price frequency for rental properties (per_month/per_year)
- **newHomes**: Filter for new homes (only/exclude)
- **added**: Filter by when property was added (24_hours, 3_days, 7_days, 14_days, 30_days)
- **propertySubType**: Property sub-type filter
- **feature**: Specific feature to search for
- **tenure**: Property tenure filter
- **smartTags**: Smart tags for advanced filtering

### Output

The actor outputs each property as an individual data item. Each property contains:

```json
{
	"aweme_id": "v15044gf0000d0f6jtnog65t69t3dme0",
	"video_id": "7502551047378832671",
	"region": "US",
	"title": "\"find your joy in what's happening today\" 🥺❤️ @Torchy Swinson ",
	"cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMAIAaioIfhIqwPEKePGeIUjUHALAANAA98QQp~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg?dr=14782&refresh_token=9a81de7e&x-expires=1747270800&x-signature=uMBOSoUR1V94wdNXQatmkOMilFs%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=maliva&s=PUBLISH&sc=cover&biz_tag=tt_video",
	"ai_dynamic_cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMAIAaioIfhIqwPEKePGeIUjUHALAANAA98QQp~tplv-tiktokx-origin.image?dr=1364&refresh_token=1128aed4&x-expires=1747270800&x-signature=nvWhc1YYcQNbmFpDCwNxZe%2BD0bk%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=132edbea&idc=maliva&biz_tag=tt_video&s=PUBLISH&sc=dynamic_cover",
	"origin_cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogmBat2fQeVoFEA6Qno4RasDAEzEViBPZRHCQ6~tplv-tiktokx-360p.webp?dr=1363&refresh_token=e6451a3f&x-expires=1747270800&x-signature=i8x4vSiblQKAxusjPK7qZxFnGmc%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=132edbea&idc=maliva&sc=feed_cover&biz_tag=tt_video&s=PUBLISH",
	"duration": 58,
	"play": "https://v16m.tiktokcdn.com/4622c355b936c4a5b974ff0153c757d7/68253e97/video/tos/maliva/tos-maliva-ve-0068c799-us/oofoutR4ExDHRe7EZaFn2Q7pE4NPIAB6msgVZA/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=1960&bt=980&cs=0&ds=6&ft=4pTgzjjM9-px8Zq8ZmCM5y7EkcAlyBywNLrFDDo5Xmoag3&mime_type=video_mp4&qs=0&rc=N2Q7ZGdmNDk7NjU4Z2ZmN0BpM3A2PHc5cnc5MzMzaTczNEAvLmEwMDRiXzYxMzEyYC0vYSNiYXEzMmRrZ2NhLS1kMTJzcw%3D%3D&vvpl=1&l=20250514090740528ACCDE0257330263AA&btag=e00088000&cc=3",
	"wmplay": "https://v16m.tiktokcdn.com/e20fb37e1d1bf0e64a0c619e0181a72e/68253e97/video/tos/maliva/tos-maliva-ve-0068c799-us/okoQVI1eAAnlEZ6sRFfPmoDBgOHd4EEtSVR2g8/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=2016&bt=1008&cs=0&ds=3&ft=4pTgzjjM9-px8Zq8ZmCM5y7EkcAlyBywNLrFDDo5Xmoag3&mime_type=video_mp4&qs=0&rc=PGk3ZDk6NTw2ODs1Njk1M0BpM3A2PHc5cnc5MzMzaTczNEBiNC8vNl4uNS0xYjRiLl4xYSNiYXEzMmRrZ2NhLS1kMTJzcw%3D%3D&vvpl=1&l=20250514090740528ACCDE0257330263AA&btag=e00088000&cc=3",
	"size": 7307087,
	"wm_size": 7517478,
	"music": "https://sf19.tiktokcdn-us.com/obj/ies-music-tx2/7502556269832719135.mp3",
	"music_info": {
		"id": "7502556199716391711",
		"title": "original sound - tiktok",
		"play": "https://sf19.tiktokcdn-us.com/obj/ies-music-tx2/7502556269832719135.mp3",
		"cover": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q75.webp?dr=10796&idc=maliva&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4",
		"author": "TikTok",
		"original": true,
		"duration": 58,
		"album": ""
	},
	"play_count": 1287045,
	"digg_count": 7611,
	"comment_count": 5358,
	"share_count": 754,
	"download_count": 77,
	"collect_count": 796,
	"create_time": 1746823813,
	"anchors": null,
	"anchors_extras": "",
	"is_ad": false,
	"commerce_info": {
		"adv_promotable": false,
		"auction_ad_invited": false,
		"branded_content_type": 0,
		"organic_log_extra": "{\"req_id\":\"20250514090740528ACCDE0257330263AA\"}",
		"with_comment_filter_words": false
	},
	"commercial_video_info": "",
	"item_comment_settings": 0,
	"mentioned_users": "6797898940689925126",
	"author": {
		"id": "107955",
		"unique_id": "tiktok",
		"nickname": "TikTok",
		"avatar": "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q75.webp?dr=10793&idc=maliva&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"
	},
	"is_top": 0,
	"scrapedAt": "2025-05-14T01:07:42.299Z"
}
```

### Usage

1. **Input Configuration**: Provide location details and search criteria
2. **Set Max Results**: Specify how many properties you want to fetch
3. **Run the Actor**: Execute the actor with your input
4. **Get Results**: Receive individual property listings in the dataset

### Examples

#### Basic Property Search

```json
{
	"locationValue": "London",
	"locationIdentifier": "london",
	"section": "for-sale",
	"bedsMin": 2,
	"bedsMax": 4,
	"priceMin": 300000,
	"priceMax": 800000,
	"maxResults": 100
}
```

#### Rental Property Search

```json
{
	"locationValue": "Manchester",
	"locationIdentifier": "manchester",
	"section": "to-rent",
	"bedsMin": 1,
	"bedsMax": 3,
	"priceMin": 800,
	"priceMax": 2000,
	"priceFrequency": "per_month",
	"petsAllowed": true,
	"maxResults": 50
}
```

#### Luxury Property Search

```json
{
	"locationValue": "Kensington",
	"locationIdentifier": "kensington",
	"section": "for-sale",
	"priceMin": 1000000,
	"sortOrder": "highest_price",
	"newHomes": "exclude",
	"maxResults": 200
}
```

### Property Data Structure

Each property listing includes:

#### Basic Information

- **address**: Property address
- **title**: Property title/description
- **listingId**: Unique listing identifier
- **publicationStatus**: Current publication status

#### Agent Information

- **agent.logoUri**: Agent company logo URL
- **agent.branchId**: Branch identifier
- **agent.branchName**: Branch name
- **agent.phone**: Contact phone number
- **agent.isDeveloper**: Whether the agent is a developer

#### Property Attributes

- **attributes.bedrooms**: Number of bedrooms
- **attributes.bathrooms**: Number of bathrooms
- **attributes.livingRooms**: Number of living rooms

#### Pricing Information

- **pricing.value**: Price value in numeric format
- **pricing.qualifier**: Price qualifier (e.g., "offers_over", "fixed_price")
- **pricing.qualifierLabel**: Human-readable qualifier label
- **pricing.label**: Formatted price display
- **shortPriceTitle**: Short price display

#### Location Data

- **location.coordinates.latitude**: Property latitude
- **location.coordinates.longitude**: Property longitude

#### Media and Features

- **imageUris**: Array of property image URLs
- **highlights**: Array of property highlights/features
- **tags**: Array of property tags with labels

#### Status Flags

- **isExpired**: Whether the listing has expired
- **isFeatured**: Whether the listing is featured
- **isPremium**: Whether the listing is premium
- **flag**: Additional status flag (if any)

### Support

For technical support or questions about this actor, please contact our support team.

# Actor input Schema

## `maxResults` (type: `integer`):

Maximum number of results to fetch

## `locationValue` (type: `string`):

The location value to search for properties (e.g., 'London', 'Manchester')

## `locationIdentifier` (type: `string`):

The location identifier for the search area

## `category` (type: `string`):

Property category filter

## `furnishedState` (type: `string`):

Furnished state filter

## `section` (type: `string`):

Property section filter

## `bedsMin` (type: `integer`):

Minimum number of bedrooms

## `bedsMax` (type: `integer`):

Maximum number of bedrooms

## `priceMin` (type: `integer`):

Minimum property price

## `priceMax` (type: `integer`):

Maximum property price

## `sortOrder` (type: `string`):

Sort order for results

## `page` (type: `integer`):

Page number for pagination

## `radius` (type: `integer`):

Search radius in miles

## `keywords` (type: `string`):

Keywords to search for in property descriptions

## `includeRented` (type: `boolean`):

Include rented properties in results

## `includeSold` (type: `boolean`):

Include sold properties in results

## `includeRetirementHomes` (type: `boolean`):

Include retirement homes in results

## `includeSharedAccommodation` (type: `boolean`):

Include shared accommodation in results

## `includeSharedOwnership` (type: `boolean`):

Include shared ownership properties in results

## `isAuction` (type: `boolean`):

Show only auction properties

## `petsAllowed` (type: `boolean`):

Show only properties that allow pets

## `billsIncluded` (type: `boolean`):

Show only properties with bills included

## `chainFree` (type: `boolean`):

Show only chain-free properties

## `reducedPriceOnly` (type: `boolean`):

Show only properties with reduced prices

## `priceFrequency` (type: `string`):

Price frequency for rental properties

## `newHomes` (type: `string`):

Filter for new homes

## `added` (type: `string`):

Filter by when property was added

## `propertySubType` (type: `string`):

Property sub-type filter

## `feature` (type: `string`):

Specific feature to search for

## `tenure` (type: `string`):

Property tenure filter

## `smartTags` (type: `string`):

Smart tags for advanced filtering

## Actor input object example

```json
{
  "maxResults": 25,
  "locationValue": "Oxford, Oxfordshire",
  "locationIdentifier": "oxford",
  "page": 1
}
```

# 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 = {
    "maxResults": 25,
    "locationValue": "Oxford, Oxfordshire",
    "locationIdentifier": "oxford"
};

// Run the Actor and wait for it to finish
const run = await client.actor("powerai/zoopla-properties-search-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 = {
    "maxResults": 25,
    "locationValue": "Oxford, Oxfordshire",
    "locationIdentifier": "oxford",
}

# Run the Actor and wait for it to finish
run = client.actor("powerai/zoopla-properties-search-scraper").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 '{
  "maxResults": 25,
  "locationValue": "Oxford, Oxfordshire",
  "locationIdentifier": "oxford"
}' |
apify call powerai/zoopla-properties-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,powerai/zoopla-properties-search-scraper"
        }
    }
}
```

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/Ecdld9mnczZ13Yma0/builds/EnCBm4BDtkCKep9HK/openapi.json