Property Finder MENA Listings & Agent Contact Extractor

{
  "description": "Search Property Finder listings across the UAE, Saudi Arabia, Qatar, Bahrain and Egypt, or scrape listing, agent and broker URLs. Returns property details and public brokerage contact data.",
  "properties": {
    "agentUrls": {
      "description": "Property Finder agent profile URLs, or bare numeric agent IDs. Used with mode=agents.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "sectionCaption": "Profiles",
      "sectionDescription": "Agent and broker profiles return public profile data and the brokerage's published contact details.",
      "title": "Agent profile URLs or IDs",
      "type": "array"
    },
    "bedrooms": {
      "default": "any",
      "description": "Bedroom filter for residential searches. Studio is supported for apartments and mixed-type searches.",
      "editor": "select",
      "enum": [
        "any",
        "studio",
        "1",
        "2",
        "3",
        "4",
        "5",
        "6",
        "7+"
      ],
      "enumTitles": [
        "Any bedrooms",
        "Studio",
        "1 bedroom",
        "2 bedrooms",
        "3 bedrooms",
        "4 bedrooms",
        "5 bedrooms",
        "6 bedrooms",
        "7+ bedrooms"
      ],
      "prefill": "any",
      "title": "Bedrooms",
      "type": "string"
    },
    "brokerUrls": {
      "description": "Property Finder broker/agency profile URLs, or bare numeric broker IDs. Used with mode=brokers.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Broker profile URLs or IDs",
      "type": "array"
    },
    "city": {
      "default": "dubai",
      "description": "City, province or governorate to search. Choose All cities for a country-wide search.",
      "editor": "select",
      "enum": [
        "all",
        "dubai",
        "abu-dhabi",
        "sharjah",
        "ajman",
        "ras-al-khaimah",
        "fujairah",
        "umm-al-quwain",
        "al-ain",
        "ar-riyadh",
        "makkah-al-mukarramah",
        "eastern",
        "al-madinah-al-munawwarah",
        "al-qassim",
        "asir",
        "tabuk",
        "hail",
        "najran",
        "jazan",
        "doha",
        "lusail",
        "al-wakra",
        "al-khor",
        "al-daayen",
        "al-shamal",
        "umm-salal-mohammed",
        "dukhan-highway",
        "capital-governorate",
        "northern-governorate",
        "southern-governorate",
        "muharraq-governorate",
        "central-governorate",
        "cairo",
        "giza",
        "alexandria",
        "north-coast",
        "new-capital",
        "asyut",
        "demyat",
        "qalyubia",
        "al-fayum",
        "red-sea",
        "south-sainai",
        "matrouh",
        "port-saeed",
        "suez",
        "sharqia",
        "el-esmailia",
        "al-behera",
        "al-daqahlya",
        "al-gharbeya",
        "al-menofeya"
      ],
      "enumTitles": [
        "All cities (country-wide)",
        "Dubai (AE)",
        "Abu Dhabi (AE)",
        "Sharjah (AE)",
        "Ajman (AE)",
        "Ras Al Khaimah (AE)",
        "Fujairah (AE)",
        "Umm Al Quwain (AE)",
        "Al Ain (AE)",
        "Riyadh (SA)",
        "Makkah (SA)",
        "Eastern Province (SA)",
        "Madinah (SA)",
        "Al Qassim (SA)",
        "Asir (SA)",
        "Tabuk (SA)",
        "Hail (SA)",
        "Najran (SA)",
        "Jazan (SA)",
        "Doha (QA)",
        "Lusail (QA)",
        "Al Wakrah (QA)",
        "Al Khor (QA)",
        "Al Daayen (QA)",
        "Al Shamal (QA)",
        "Umm Salal Mohammed (QA)",
        "Dukhan Highway (QA)",
        "Capital Governorate (BH)",
        "Northern Governorate (BH)",
        "Southern Governorate (BH)",
        "Muharraq Governorate (BH)",
        "Central Governorate (BH)",
        "Cairo (EG)",
        "Giza (EG)",
        "Alexandria (EG)",
        "North Coast (EG)",
        "New Capital (EG)",
        "Asyut (EG)",
        "Damietta (EG)",
        "Qalyubia (EG)",
        "Fayoum (EG)",
        "Red Sea (EG)",
        "South Sinai (EG)",
        "Matrouh (EG)",
        "Port Said (EG)",
        "Suez (EG)",
        "Sharqia (EG)",
        "Ismailia (EG)",
        "Beheira (EG)",
        "Dakahlia (EG)",
        "Gharbia (EG)",
        "Menofia (EG)"
      ],
      "prefill": "dubai",
      "title": "City / province",
      "type": "string"
    },
    "completionStatus": {
      "default": "any",
      "description": "Ready or off-plan. Applies to residential for-sale searches; ignored for rentals and commercial searches.",
      "editor": "select",
      "enum": [
        "any",
        "completed",
        "off_plan"
      ],
      "enumTitles": [
        "Any completion status",
        "Ready",
        "Off-plan"
      ],
      "prefill": "any",
      "title": "Completion status",
      "type": "string"
    },
    "country": {
      "default": "ae",
      "description": "Market to search or the country used for bare agent/broker ids.",
      "editor": "select",
      "enum": [
        "ae",
        "sa",
        "qa",
        "bh",
        "eg"
      ],
      "enumTitles": [
        "United Arab Emirates",
        "Saudi Arabia",
        "Qatar",
        "Bahrain",
        "Egypt"
      ],
      "prefill": "ae",
      "sectionCaption": "Search filters",
      "sectionDescription": "Used with mode=search. Pick a city that belongs to this country, or choose All cities.",
      "title": "Country",
      "type": "string"
    },
    "furnishing": {
      "default": "any",
      "description": "Furnished or unfurnished. Leave on Any furnishing to include both.",
      "editor": "select",
      "enum": [
        "any",
        "furnished",
        "unfurnished"
      ],
      "enumTitles": [
        "Any furnishing",
        "Furnished",
        "Unfurnished"
      ],
      "prefill": "any",
      "title": "Furnishing",
      "type": "string"
    },
    "includeDetails": {
      "default": true,
      "description": "Open each listing page to add the full photo gallery, permit validation link, licences, floor plans and agent ratings. Turn off for a faster, lighter dataset.",
      "prefill": true,
      "title": "Include full listing details",
      "type": "boolean"
    },
    "maxItems": {
      "default": 100,
      "description": "Maximum number of listings or profiles to return.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 2,
      "sectionCaption": "Output",
      "sectionDescription": "The run stops at this many records or when the source runs out.",
      "title": "Max records",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "What to scrape. Search listings by filters, scrape specific listing URLs, or collect agent/broker profiles.",
      "editor": "select",
      "enum": [
        "search",
        "listings",
        "agents",
        "brokers"
      ],
      "enumTitles": [
        "Search listings by filters",
        "Scrape listing or search URLs",
        "Scrape agent profiles",
        "Scrape broker profiles"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "priceMax": {
      "description": "Maximum asking price in the market's local currency.",
      "maximum": 1000000000,
      "minimum": 0,
      "title": "Maximum price",
      "type": "integer"
    },
    "priceMin": {
      "description": "Minimum asking price in the market's local currency (AED, SAR, QAR, BHD or EGP).",
      "maximum": 1000000000,
      "minimum": 0,
      "title": "Minimum price",
      "type": "integer"
    },
    "propertyType": {
      "default": "any",
      "description": "Residential types: apartment, villa, townhouse, penthouse, duplex, compound, land, whole building, half floor. Commercial types: office, shop, warehouse, factory, showroom.",
      "editor": "select",
      "enum": [
        "any",
        "apartment",
        "villa",
        "townhouse",
        "penthouse",
        "duplex",
        "compound",
        "land",
        "whole-building",
        "half-floor",
        "office",
        "shop",
        "warehouse",
        "factory",
        "showroom"
      ],
      "enumTitles": [
        "Any property type",
        "Apartment",
        "Villa",
        "Townhouse",
        "Penthouse",
        "Duplex",
        "Compound",
        "Land",
        "Whole building",
        "Half floor",
        "Office",
        "Shop",
        "Warehouse",
        "Factory",
        "Showroom"
      ],
      "prefill": "apartment",
      "title": "Property type",
      "type": "string"
    },
    "purpose": {
      "default": "buy",
      "description": "Buy, rent, or the commercial equivalents.",
      "editor": "select",
      "enum": [
        "buy",
        "rent",
        "commercial-buy",
        "commercial-rent"
      ],
      "enumTitles": [
        "For sale",
        "For rent",
        "Commercial for sale",
        "Commercial for rent"
      ],
      "prefill": "buy",
      "title": "Purpose",
      "type": "string"
    },
    "startUrls": {
      "description": "Property Finder landing, search, listing or short URLs. Used with mode=listings. Sitemap and sitemap-index URLs are also accepted.",
      "editor": "requestListSources",
      "sectionCaption": "URLs",
      "sectionDescription": "Use these instead of the search filters when you already have Property Finder links.",
      "title": "Listing or search URLs",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Property Finder MENA Listings & Brokerage Contacts Input",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Dataset of Property Finder listings, agent profiles and brokerages with prices, location, amenities, permit data, media and public broker/listing contact details.",
  "properties": {
    "listings": {
      "description": "Listing, agent and broker records produced by this run.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Property Finder records",
      "type": "string"
    }
  },
  "title": "Property Finder MENA Listings & Brokerage Contacts Output",
  "type": "object"
}

{
  "actorSpecification": 1,
  "views": {
    "contacts": {
      "display": {
        "component": "table"
      },
      "title": "Contacts",
      "transformation": {
        "fields": [
          "recordType",
          "title",
          "agentName",
          "agentProfileUrl",
          "brokerName",
          "brokerEmail",
          "brokerPhone",
          "brokerWhatsapp",
          "contactPhone",
          "contactWhatsapp",
          "url"
        ]
      }
    },
    "detailed": {
      "display": {
        "component": "table"
      },
      "title": "Detailed",
      "transformation": {
        "fields": [
          "title",
          "purpose",
          "price",
          "priceCurrency",
          "priceDuration",
          "pricePerArea",
          "pricePerAreaUnit",
          "propertyType",
          "offeringType",
          "bedrooms",
          "bathrooms",
          "size",
          "sizeUnit",
          "furnished",
          "completionStatus",
          "city",
          "community",
          "subCommunity",
          "tower",
          "agentName",
          "agentRating",
          "brokerName",
          "brokerEmail",
          "brokerPhone",
          "brokerWhatsapp",
          "permitNumber",
          "permitValidationUrl",
          "isVerified",
          "floorPlanCount",
          "imagesCount",
          "listedDate",
          "url"
        ]
      }
    },
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "bathrooms": {
            "format": "number",
            "label": "Baths"
          },
          "bedrooms": {
            "format": "number",
            "label": "Beds"
          },
          "brokerName": {
            "format": "text",
            "label": "Brokerage"
          },
          "brokerPhone": {
            "format": "text",
            "label": "Broker phone"
          },
          "city": {
            "format": "text",
            "label": "City"
          },
          "community": {
            "format": "text",
            "label": "Community"
          },
          "isVerified": {
            "format": "boolean",
            "label": "Verified"
          },
          "price": {
            "format": "number",
            "label": "Price"
          },
          "priceCurrency": {
            "format": "text",
            "label": "Currency"
          },
          "propertyType": {
            "format": "text",
            "label": "Type"
          },
          "purpose": {
            "format": "text",
            "label": "Purpose"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "url": {
            "format": "link",
            "label": "URL"
          }
        }
      },
      "title": "Overview",
      "transformation": {
        "fields": [
          "title",
          "purpose",
          "price",
          "priceCurrency",
          "propertyType",
          "bedrooms",
          "bathrooms",
          "city",
          "community",
          "brokerName",
          "brokerPhone",
          "isVerified",
          "url"
        ]
      }
    }
  }
}