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:

{
	"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

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

Rental Property Search

{
	"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

{
	"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.