How to scrape Property Finder

# Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 propertyfinder_listing_sdk.py

import json
import os
import sys
import time
from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
START_URL = "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html"
PAGES = 3
SETTINGS = {
    "js": True,
    "proxy_type": "premium",
    "proxy_country": "AE",
}
EXTRACT_RULES = {
    "listings": {
        "selector": "li[data-testid^='list-item-'] article[data-testid='property-card']",
        "type": "obj",
        "multiple": True,
        "children": {
            "url": {
                "selector": "a[data-testid='property-card-link']",
                "type": "link",
            },
            "title": {
                "selector": "h3.styles-module_content__title__maprN",
                "type": "text",
            },
            "price": {
                "selector": "[data-testid='property-card-price']",
                "type": "text",
            },
            "bedrooms": {
                "selector": "[data-testid='property-card-spec-bedroom']",
                "type": "text",
            },
            "bathrooms": {
                "selector": "[data-testid='property-card-spec-bathroom']",
                "type": "text",
            },
            "area": {
                "selector": "[data-testid='property-card-spec-area']",
                "type": "text",
            },
            "property_type": {
                "selector": "[data-testid='property-card-spec-propertyType']",
                "type": "text",
            },
            "neighborhood": {
                "selector": "[data-testid='property-card-location']",
                "type": "text",
            },
            "image": {
                "selector": ".styles_desktop_gallery-image__n81d5",
                "type": "image",
            },
        },
    },
}


def page_url(page):
    if page == 1:
        return START_URL
    parts = urlsplit(START_URL)
    query = dict(parse_qsl(parts.query))
    query["page"] = str(page)
    return urlunsplit(parts._replace(query=urlencode(query)))


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for page in range(1, PAGES + 1):
    result = scrape(client, page_url(page))
    print(json.dumps(result, indent=2, ensure_ascii=False))
    if not result.get("listings"):
        break
    time.sleep(2)  # be polite: one page at a time

// Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Uses the official SDK @ujeebu-org/ujeebu-sdk 0.1.2: npm install @ujeebu-org/ujeebu-sdk@0.1.2
// Run: UJEEBU_API_KEY=your_key node propertyfinder_listing_sdk.mjs

import { UjeebuClient } from '@ujeebu-org/ujeebu-sdk';

const API_KEY = process.env.UJEEBU_API_KEY;
const START_URL = "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html";
const PAGES = 3;
const SETTINGS = {
  js: true,
  proxy_type: "premium",
  proxy_country: "AE",
};
const EXTRACT_RULES = {
  listings: {
    selector: "li[data-testid^='list-item-'] article[data-testid='property-card']",
    type: "obj",
    multiple: true,
    children: {
      url: {
        selector: "a[data-testid='property-card-link']",
        type: "link",
      },
      title: {
        selector: "h3.styles-module_content__title__maprN",
        type: "text",
      },
      price: {
        selector: "[data-testid='property-card-price']",
        type: "text",
      },
      bedrooms: {
        selector: "[data-testid='property-card-spec-bedroom']",
        type: "text",
      },
      bathrooms: {
        selector: "[data-testid='property-card-spec-bathroom']",
        type: "text",
      },
      area: {
        selector: "[data-testid='property-card-spec-area']",
        type: "text",
      },
      property_type: {
        selector: "[data-testid='property-card-spec-propertyType']",
        type: "text",
      },
      neighborhood: {
        selector: "[data-testid='property-card-location']",
        type: "text",
      },
      image: {
        selector: ".styles_desktop_gallery-image__n81d5",
        type: "image",
      },
    },
  },
};

function pageUrl(page) {
  if (page === 1) return START_URL;
  const url = new URL(START_URL);
  url.searchParams.set("page", String(page));
  return url.toString();
}

async function scrape(client, url) {
  let res;
  try {
    // client.scrape POSTs JSON when extract_rules is set (scrapeWithRules would send it as a GET query, which the API ignores)
    res = await client.scrape(url, { ...SETTINGS, extract_rules: EXTRACT_RULES });
  } catch (err) {
    const status = err.response?.status ?? 'error';
    const message = err.response?.data?.message ?? err.message;
    console.error(`HTTP ${status} for ${url}: ${String(message).slice(0, 300)}`);
    process.exit(1);
  }
  console.error(`Ujb-Credits: ${res.headers['ujb-credits']}`);
  return res.data.result;
}

if (!API_KEY) {
  console.error('Set the UJEEBU_API_KEY environment variable.');
  process.exit(1);
}

const client = new UjeebuClient(API_KEY);
const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

for (let page = 1; page <= PAGES; page++) {
  const result = await scrape(client, pageUrl(page));
  console.log(JSON.stringify(result, null, 2));
  if (!result?.listings?.length) break;
  await pause(2000); // be polite: one page at a time
}

# Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Run: UJEEBU_API_KEY=your_key python3 propertyfinder_listing.py   (pip install requests)

import json
import os
import sys
import time
from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit

import requests

API_URL = "https://api.ujeebu.com/scrape"
API_KEY = os.environ.get("UJEEBU_API_KEY")
START_URL = "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html"
PAGES = 3
SETTINGS = {
    "js": True,
    "proxy_type": "premium",
    "proxy_country": "AE",
}
EXTRACT_RULES = {
    "listings": {
        "selector": "li[data-testid^='list-item-'] article[data-testid='property-card']",
        "type": "obj",
        "multiple": True,
        "children": {
            "url": {
                "selector": "a[data-testid='property-card-link']",
                "type": "link",
            },
            "title": {
                "selector": "h3.styles-module_content__title__maprN",
                "type": "text",
            },
            "price": {
                "selector": "[data-testid='property-card-price']",
                "type": "text",
            },
            "bedrooms": {
                "selector": "[data-testid='property-card-spec-bedroom']",
                "type": "text",
            },
            "bathrooms": {
                "selector": "[data-testid='property-card-spec-bathroom']",
                "type": "text",
            },
            "area": {
                "selector": "[data-testid='property-card-spec-area']",
                "type": "text",
            },
            "property_type": {
                "selector": "[data-testid='property-card-spec-propertyType']",
                "type": "text",
            },
            "neighborhood": {
                "selector": "[data-testid='property-card-location']",
                "type": "text",
            },
            "image": {
                "selector": ".styles_desktop_gallery-image__n81d5",
                "type": "image",
            },
        },
    },
}


def page_url(page):
    if page == 1:
        return START_URL
    parts = urlsplit(START_URL)
    query = dict(parse_qsl(parts.query))
    query["page"] = str(page)
    return urlunsplit(parts._replace(query=urlencode(query)))


def scrape(url):
    response = requests.post(
        API_URL,
        headers={"ApiKey": API_KEY},
        json={"url": url, **SETTINGS, "extract_rules": EXTRACT_RULES},
        timeout=180,
    )
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

for page in range(1, PAGES + 1):
    result = scrape(page_url(page))
    print(json.dumps(result, indent=2, ensure_ascii=False))
    if not result.get("listings"):
        break
    time.sleep(2)  # be polite: one page at a time

// Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Run: UJEEBU_API_KEY=your_key node propertyfinder_listing.mjs   (Node.js 18 or later)

const API_URL = 'https://api.ujeebu.com/scrape';
const API_KEY = process.env.UJEEBU_API_KEY;
const START_URL = "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html";
const PAGES = 3;
const SETTINGS = {
  js: true,
  proxy_type: "premium",
  proxy_country: "AE",
};
const EXTRACT_RULES = {
  listings: {
    selector: "li[data-testid^='list-item-'] article[data-testid='property-card']",
    type: "obj",
    multiple: true,
    children: {
      url: {
        selector: "a[data-testid='property-card-link']",
        type: "link",
      },
      title: {
        selector: "h3.styles-module_content__title__maprN",
        type: "text",
      },
      price: {
        selector: "[data-testid='property-card-price']",
        type: "text",
      },
      bedrooms: {
        selector: "[data-testid='property-card-spec-bedroom']",
        type: "text",
      },
      bathrooms: {
        selector: "[data-testid='property-card-spec-bathroom']",
        type: "text",
      },
      area: {
        selector: "[data-testid='property-card-spec-area']",
        type: "text",
      },
      property_type: {
        selector: "[data-testid='property-card-spec-propertyType']",
        type: "text",
      },
      neighborhood: {
        selector: "[data-testid='property-card-location']",
        type: "text",
      },
      image: {
        selector: ".styles_desktop_gallery-image__n81d5",
        type: "image",
      },
    },
  },
};

function pageUrl(page) {
  if (page === 1) return START_URL;
  const url = new URL(START_URL);
  url.searchParams.set("page", String(page));
  return url.toString();
}

async function scrape(url) {
  const res = await fetch(API_URL, {
    method: 'POST',
    headers: { ApiKey: API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ url, ...SETTINGS, extract_rules: EXTRACT_RULES }),
    signal: AbortSignal.timeout(180000),
  });
  const text = await res.text();
  if (res.status !== 200) {
    let message = text;
    try {
      message = JSON.parse(text).message ?? text;
    } catch {}
    console.error(`HTTP ${res.status} for ${url}: ${String(message).slice(0, 300)}`);
    process.exit(1);
  }
  console.error(`Ujb-Credits: ${res.headers.get('ujb-credits')}`);
  return JSON.parse(text).result;
}

if (!API_KEY) {
  console.error('Set the UJEEBU_API_KEY environment variable.');
  process.exit(1);
}

const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

for (let page = 1; page <= PAGES; page++) {
  const result = await scrape(pageUrl(page));
  console.log(JSON.stringify(result, null, 2));
  if (!result?.listings?.length) break;
  await pause(2000); // be polite: one page at a time
}

#!/usr/bin/env bash
# Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Run: UJEEBU_API_KEY=your_key bash propertyfinder_listing.sh   (curl 7.76 or later)
set -euo pipefail

curl -sS --fail-with-body --max-time 180 -D headers.txt \
  -X POST 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: ${UJEEBU_API_KEY:?Set the UJEEBU_API_KEY environment variable.}" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "url": "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html",
  "js": true,
  "proxy_type": "premium",
  "proxy_country": "AE",
  "extract_rules": {
    "listings": {
      "selector": "li[data-testid^='list-item-'] article[data-testid='property-card']",
      "type": "obj",
      "multiple": true,
      "children": {
        "url": {
          "selector": "a[data-testid='property-card-link']",
          "type": "link"
        },
        "title": {
          "selector": "h3.styles-module_content__title__maprN",
          "type": "text"
        },
        "price": {
          "selector": "[data-testid='property-card-price']",
          "type": "text"
        },
        "bedrooms": {
          "selector": "[data-testid='property-card-spec-bedroom']",
          "type": "text"
        },
        "bathrooms": {
          "selector": "[data-testid='property-card-spec-bathroom']",
          "type": "text"
        },
        "area": {
          "selector": "[data-testid='property-card-spec-area']",
          "type": "text"
        },
        "property_type": {
          "selector": "[data-testid='property-card-spec-propertyType']",
          "type": "text"
        },
        "neighborhood": {
          "selector": "[data-testid='property-card-location']",
          "type": "text"
        },
        "image": {
          "selector": ".styles_desktop_gallery-image__n81d5",
          "type": "image"
        }
      }
    }
  }
}
JSON
echo
grep -i '^ujb-credits' headers.txt >&2

<?php
// Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Run: UJEEBU_API_KEY=your_key php propertyfinder_listing.php   (PHP 7.4 or later with curl)

$apiKey = getenv('UJEEBU_API_KEY') ?: exit("Set the UJEEBU_API_KEY environment variable.\n");
$startUrl = 'https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html';
$pages = 3;
$settings = [
    'js' => true,
    'proxy_type' => 'premium',
    'proxy_country' => 'AE',
];
$extractRules = [
    'listings' => [
        'selector' => 'li[data-testid^=\'list-item-\'] article[data-testid=\'property-card\']',
        'type' => 'obj',
        'multiple' => true,
        'children' => [
            'url' => [
                'selector' => 'a[data-testid=\'property-card-link\']',
                'type' => 'link',
            ],
            'title' => [
                'selector' => 'h3.styles-module_content__title__maprN',
                'type' => 'text',
            ],
            'price' => [
                'selector' => '[data-testid=\'property-card-price\']',
                'type' => 'text',
            ],
            'bedrooms' => [
                'selector' => '[data-testid=\'property-card-spec-bedroom\']',
                'type' => 'text',
            ],
            'bathrooms' => [
                'selector' => '[data-testid=\'property-card-spec-bathroom\']',
                'type' => 'text',
            ],
            'area' => [
                'selector' => '[data-testid=\'property-card-spec-area\']',
                'type' => 'text',
            ],
            'property_type' => [
                'selector' => '[data-testid=\'property-card-spec-propertyType\']',
                'type' => 'text',
            ],
            'neighborhood' => [
                'selector' => '[data-testid=\'property-card-location\']',
                'type' => 'text',
            ],
            'image' => [
                'selector' => '.styles_desktop_gallery-image__n81d5',
                'type' => 'image',
            ],
        ],
    ],
];

function scrape(string $url, string $apiKey, array $settings, array $extractRules)
{
    $ch = curl_init('https://api.ujeebu.com/scrape');
    $headers = [];
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 180,
        CURLOPT_HTTPHEADER => ['ApiKey: ' . $apiKey, 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode(['url' => $url] + $settings + ['extract_rules' => $extractRules]),
        CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$headers) {
            if (strpos($line, ':') !== false) {
                [$k, $v] = explode(':', $line, 2);
                $headers[strtolower(trim($k))] = trim($v);
            }
            return strlen($line);
        },
    ]);
    $body = curl_exec($ch);
    if ($body === false) {
        fwrite(STDERR, 'Request failed: ' . curl_error($ch) . "\n");
        exit(1);
    }
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    if ($status !== 200) {
        $message = json_decode($body, true)['message'] ?? $body;
        fwrite(STDERR, "HTTP $status for $url: " . substr((string) $message, 0, 300) . "\n");
        exit(1);
    }
    fwrite(STDERR, 'Ujb-Credits: ' . ($headers['ujb-credits'] ?? '?') . "\n");
    return json_decode($body, true)['result'];
}

for ($page = 1; $page <= $pages; $page++) {
    $parts = parse_url($startUrl);
    parse_str($parts['query'] ?? '', $query);
    $query['page'] = (string) ($page);
    $url = $page === 1 ? $startUrl : $parts['scheme'] . '://' . $parts['host'] . ($parts['path'] ?? '/') . '?' . http_build_query($query);
    $result = scrape($url, $apiKey, $settings, $extractRules);
    echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), "\n";
    if (empty($result['listings'])) {
        break;
    }
    sleep(2); // be polite: one page at a time
}

// Scrape Property Finder search and listing pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Uses the official SDK github.com/ujeebu/ujeebu-go v0.1.8: go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8
// Run: UJEEBU_API_KEY=your_key go run propertyfinder_listing.go

package main

import (
	"encoding/json"
	"errors"
	"fmt"
	"net/url"
	"os"
	"strconv"
	"time"

	ujeebu "github.com/ujeebu/ujeebu-go"
)

const startURL = "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html"

const pages = 3

// The extract rules of the recipe, as the JSON the API takes.
const extractRulesJSON = `{
    "listings": {
        "selector": "li[data-testid^='list-item-'] article[data-testid='property-card']",
        "type": "obj",
        "multiple": true,
        "children": {
            "url": {
                "selector": "a[data-testid='property-card-link']",
                "type": "link"
            },
            "title": {
                "selector": "h3.styles-module_content__title__maprN",
                "type": "text"
            },
            "price": {
                "selector": "[data-testid='property-card-price']",
                "type": "text"
            },
            "bedrooms": {
                "selector": "[data-testid='property-card-spec-bedroom']",
                "type": "text"
            },
            "bathrooms": {
                "selector": "[data-testid='property-card-spec-bathroom']",
                "type": "text"
            },
            "area": {
                "selector": "[data-testid='property-card-spec-area']",
                "type": "text"
            },
            "property_type": {
                "selector": "[data-testid='property-card-spec-propertyType']",
                "type": "text"
            },
            "neighborhood": {
                "selector": "[data-testid='property-card-location']",
                "type": "text"
            },
            "image": {
                "selector": ".styles_desktop_gallery-image__n81d5",
                "type": "image"
            }
        }
    }
}`

var extractRules map[string]any

func fail(format string, args ...any) {
	fmt.Fprintf(os.Stderr, format+"\n", args...)
	os.Exit(1)
}

func short(s string) string {
	if len(s) > 300 {
		return s[:300]
	}
	return s
}

func params(target string) ujeebu.ScrapeParams {
	p := ujeebu.ScrapeParams{URL: target}
	p.JS = true
	p.ProxyType = "premium"
	p.ProxyCountry = "AE"
	p.ExtractRules = extractRules
	return p
}

func pageURL(page int) string {
	if page == 1 {
		return startURL
	}
	u, err := url.Parse(startURL)
	if err != nil {
		fail("Bad start URL: %v", err)
	}
	q := u.Query()
	q.Set("page", strconv.Itoa(page))
	u.RawQuery = q.Encode()
	return u.String()
}

func scrape(client *ujeebu.Client, target string) map[string]any {
	// the int is the credits the request cost (the Ujb-Credits header), not an HTTP status
	resp, credits, err := client.Scrape(params(target))
	if err != nil {
		var apiErr *ujeebu.APIError
		if errors.As(err, &apiErr) {
			fail("HTTP %d for %s: %s", apiErr.StatusCode, target, short(apiErr.Message))
		}
		fail("Request failed for %s: %v", target, err)
	}
	fmt.Fprintf(os.Stderr, "Ujb-Credits: %d\n", credits)
	result, _ := resp.Result.(map[string]any)
	return result
}

func printJSON(v any) {
	enc := json.NewEncoder(os.Stdout)
	enc.SetEscapeHTML(false)
	enc.SetIndent("", "  ")
	if err := enc.Encode(v); err != nil {
		fail("Cannot print the result: %v", err)
	}
}

func main() {
	apiKey := os.Getenv("UJEEBU_API_KEY")
	if apiKey == "" {
		fail("Set the UJEEBU_API_KEY environment variable.")
	}
	if err := json.Unmarshal([]byte(extractRulesJSON), &extractRules); err != nil {
		fail("Bad extract rules: %v", err)
	}
	client, err := ujeebu.NewClient(apiKey, ujeebu.WithTimeout(180*time.Second))
	if err != nil {
		fail("%v", err)
	}

	for page := 1; page <= pages; page++ {
		result := scrape(client, pageURL(page))
		printJSON(result)
		items, _ := result["listings"].([]any)
		if len(items) == 0 {
			break
		}
		time.Sleep(2 * time.Second) // be polite: one page at a time
	}
}