Propertyfinder Scraper

A high-performance Apify actor that fetches PropertyFinder data and extracts comprehensive property listing data. This scraper delivers fast, efficient results with minimal compute usage by leveraging our optimized endpoints.

🎯 What does this actor do?

This actor:

1. Connects to fetch PropertyFinder property listings
2. Filters results by location, property type, price range, and other parameters
3. Fetches property listings in optimized batches for efficiency
4. Extracts comprehensive data from each listing
5. Returns structured property data in JSON format

📋 Input Parameters

The actor accepts the following input parameters:

{
  "location": "dubai",
  "propertyType": "apartment",
  "listingType": "rent",
  "minPrice": 50000,
  "maxPrice": 150000,
  "bedrooms": "2",
  "onlyActive": true,
  "limit": 100,
  "offset": 0,
  "apiEndpoint": "https://api.trendstore.ai/listings"
}

Input Parameters

• location (string, optional): Location to search for properties

  • Examples: "dubai", "abu-dhabi", "sharjah", "ajman"
  • Default: "dubai"

• propertyType (string, optional): Type of property to search

  • Options: "apartment", "villa", "townhouse", "penthouse", "compound", "duplex", "plot"
  • Default: "apartment"

• listingType (string, optional): Type of listing

  • Options: "rent", "sale"
  • Default: "rent"

• minPrice (number, optional): Minimum price filter

  • Example: 50000 for AED 50,000

• maxPrice (number, optional): Maximum price filter

  • Example: 150000 for AED 150,000

• bedrooms (string, optional): Number of bedrooms

  • Options: "studio", "1", "2", "3", "4", "5", "6", "7+", "1-3" (range)
  • Example: "2" for 2 bedrooms, "1-3" for 1 to 3 bedrooms

• onlyActive (boolean, optional): Filter for active listings only

  • Default: true

• limit (number, optional): Maximum number of results to fetch

  • Use 0 for unlimited results (fetches all available)
  • Maximum when specified: 1000
  • Default: 1000

• offset (number, optional): Number of results to skip for pagination

  • Default: 0

• apiEndpoint (string, optional): Endpoint URL for fetching listings

  • Default: "https://api.trendstore.ai/listings"
  • Can be customized to point to your own instance

Note: This actor automatically filters for PropertyFinder listings only (excludes Bayut listings) to ensure data consistency and relevance.

Default Behavior

The scraper automatically:

• Fetches results in optimized batches for best performance
• Processes 1000 available results
• Filters for active listings only (configurable via onlyActive)
• Handles pagination automatically

📊 Output Data Structure

The actor outputs an array of listing objects with the following structure:

{
  "id": "pf-123456",
  "title": "Luxurious 2BR Apartment | Marina View | Chiller Free",
  "location": "Dubai Marina, Dubai",
  "propertyType": "apartment",
  "listingType": "rent",
  "price": 120000,
  "bedrooms": 2,
  "bathrooms": 3,
  "area": 1500.00,
  "furnished": "furnished",
  
  "description": "Stunning 2-bedroom apartment in Dubai Marina with panoramic views...",
  
  "amenities": [
    "Swimming Pool",
    "Gym",
    "Parking",
    "Security",
    "Balcony",
    "Central A/C",
    "Kitchen Appliances"
  ],
  
  "images": [
    "https://www.propertyfinder.ae/property/image1.jpg",
    "https://www.propertyfinder.ae/property/image2.jpg",
    "https://www.propertyfinder.ae/property/image3.jpg"
  ],
  
  "agentName": "John Smith",
  "agentPhone": "+971 50 123 4567",
  "referenceNumber": "AX-R-12345",
  "listedDate": "2025-01-15",
  "propertyUrl": "https://www.propertyfinder.ae/en/rent/apartment-for-rent-dubai-marina-123456.html",
  "isActive": true,
  "source": "propertyfinder",
  "scrapedAt": "2025-01-20T10:30:00.000Z"
}

Data Fields Explanation

• Property Details: Unique ID, title, location, type, and listing type
• Pricing: Price in AED (annual for rent, total for sale)
• Specifications: Bedrooms, bathrooms, area (in sq. ft.), furnished status
• Description: Detailed property description
• Amenities: List of available amenities and features
• Images: Array of property image URLs
• Agent Information: Name and contact phone number
• Listing Metadata: Reference number, listing date, direct property URL
• Status: Active/inactive status and data extraction timestamp

Summary Statistics

The actor also provides summary statistics in the key-value store:

{
  "totalListings": 250,
  "requestedLimit": 0,
  "initialOffset": 0,
  "location": "dubai",
  "propertyType": "apartment",
  "listingType": "rent",
  "onlyActive": true,
  "scrapedAt": "2025-01-20T10:30:00.000Z"
}

🚀 Example Usage

Basic Search - All Dubai Apartments for Rent

{
  "location": "dubai",
  "propertyType": "apartment",
  "listingType": "rent",
  "limit": 100
}

Filtered Search - 2BR Apartments in Specific Price Range

{
  "location": "dubai-marina",
  "propertyType": "apartment",
  "listingType": "rent",
  "bedrooms": "2",
  "minPrice": 80000,
  "maxPrice": 150000,
  "limit": 50
}

Villas for Sale with Pagination

{
  "location": "dubai",
  "propertyType": "villa",
  "listingType": "sale",
  "minPrice": 2000000,
  "limit": 100,
  "offset": 100
}

Get All Available Results

{
  "location": "abu-dhabi",
  "propertyType": "apartment",
  "listingType": "rent",
  "limit": 0
}

⚙️ Key Features

• High Performance: Optimized data retrieval for minimal compute usage
• Comprehensive Data: Full property details including images, amenities, and agent information
• Flexible Filtering: Search by location, property type, price range, and bedrooms
• Unlimited Results: Set limit to 0 to fetch all available listings matching your criteria
• Batch Processing: Efficient data retrieval in optimized batches
• Active Listing Filter: Option to show only currently active listings
• Pagination Support: Use offset and limit for controlled data retrieval
• Customizable Endpoint: Point to your own instance for private deployments
• Source Filtering: Automatically filters for PropertyFinder listings only (excludes Bayut data)

🔧 Troubleshooting

Common Issues

1. No Results Found:

   • Try broadening your search criteria (remove price filters, expand location)
   • Check if the location name is spelled correctly
   • Verify the property type exists in the selected location

2. Fewer Results Than Expected:

   • Check if onlyActive is set to true - some properties may be inactive
   • Try adjusting your price range or bedroom filters
   • Some locations may have limited inventory for specific property types

3. Price Filtering:

   • Ensure price values are numeric (not strings)
   • Rent prices are typically annual in AED
   • Sale prices are total property value in AED

4. Large Data Sets:

   • For very large result sets, consider using pagination with offset and limit
   • Monitor your Apify compute units when fetching unlimited results

5. Connection Issues:

   • Verify the apiEndpoint URL is correct and accessible
   • Check if the server is running and responding
   • Ensure your instance has the latest data

📝 Important Notes

• Optimized Performance: This actor uses efficient data retrieval for lower compute usage
• Unlimited Results: Set limit to 0 to fetch all available listings matching your criteria
• Price Units: All prices are in AED (UAE Dirhams)
• Area Units: Property areas are in square feet
• Active Listings: By default, only active listings are returned. Set onlyActive to false to include inactive listings
• Data Freshness: Property availability and prices are subject to change

🔒 Privacy & Legal

This actor accesses publicly available property listing data. Users are responsible for:

• Using the data in compliance with applicable laws and regulations
• Respecting PropertyFinder's terms of service
• Using the data ethically and for legitimate business purposes
• Not using the data for spam, harassment, or unauthorized commercial activities

💬 Support

For issues, questions, or feature requests, please contact the actor maintainer through the Apify platform or leave feedback in the actor's discussion section.