Real Estate

Bayut UAE Property Listings

Every residential and commercial property for sale and for rent on Bayut, the largest UAE property portal — Dubai by default, any emirate on request. Price and rent frequency, size in sqft, beds and baths, off-plan or ready, the full location hierarchy with coordinates, furnishing, amenities, TruCheck and verification status, developer and completion date, and the listing agent and agency with their RERA licence numbers.

bayut-listingsbayutuaedubaireal-estatepropertylistingsrentsaleoff-plan

0 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/bayut-listings/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/bayut-listings/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "emirates": [        "dubai"      ],      "purposes": [        "for-sale",        "for-rent"      ],      "categories": [        "residential",        "commercial"      ],      "maxListings": 10000000    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

emirates
enum[]
Emirates
Default
["dubai"]
Allowed values
dubai
abu-dhabi
sharjah
ajman
ras-al-khaimah
umm-al-quwain
fujairah
al-ain
purposes
enum[]
Purpose
Default
["for-sale","for-rent"]
Allowed values
for-sale
for-rent
categories
enum[]
Property categories
Default
["residential","commercial"]
Allowed values
residential
commercial

Advanced

maxListings
number
Max listings per run
Default
10000000
Range
1 to 10000000
hitsPerPage
number
Results per request
Default
250
Range
1 to 1000
requestDelayMs
number
Delay between requests (ms)
Default
250
Range
0 to 30000

Access

algoliaHost
string
Search host
The Algolia-compatible host the Bayut site queries.
Default
https://search-dsn.bayut.com
algoliaApiKey
string
Search API key
The x-algolia-api-key the Bayut site sends. Update it if Bayut rotates its frontend key.
Default
strat_a5e4568c
algoliaAgent
string
Search agent
Default
strat-bayut-prod-fec/09d7f4d0

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "emirates": {      "type": "array",      "items": {        "type": "string",        "enum": [          "dubai",          "abu-dhabi",          "sharjah",          "ajman",          "ras-al-khaimah",          "umm-al-quwain",          "fujairah",          "al-ain"        ]      },      "uniqueItems": true,      "title": "Emirates",      "default": [        "dubai"      ]    },    "purposes": {      "type": "array",      "items": {        "type": "string",        "enum": [          "for-sale",          "for-rent"        ]      },      "uniqueItems": true,      "title": "Purpose",      "default": [        "for-sale",        "for-rent"      ]    },    "categories": {      "type": "array",      "items": {        "type": "string",        "enum": [          "residential",          "commercial"        ]      },      "uniqueItems": true,      "title": "Property categories",      "default": [        "residential",        "commercial"      ]    },    "maxListings": {      "type": "number",      "minimum": 1,      "maximum": 10000000,      "title": "Max listings per run",      "default": 10000000    },    "algoliaHost": {      "type": "string",      "maxLength": 2000,      "title": "Search host",      "description": "The Algolia-compatible host the Bayut site queries.",      "default": "https://search-dsn.bayut.com"    },    "algoliaApiKey": {      "type": "string",      "maxLength": 2000,      "title": "Search API key",      "description": "The x-algolia-api-key the Bayut site sends. Update it if Bayut rotates its frontend key.",      "default": "strat_a5e4568c"    },    "algoliaAgent": {      "type": "string",      "maxLength": 2000,      "title": "Search agent",      "default": "strat-bayut-prod-fec/09d7f4d0"    },    "hitsPerPage": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Results per request",      "default": 250    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between requests (ms)",      "default": 250    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/bayut-listings/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "emirates": [        "dubai"      ],      "purposes": [        "for-sale",        "for-rent"      ],      "categories": [        "residential",        "commercial"      ],      "maxListings": 10000000    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

No rows collected yet, so no fields have been observed. Run the scraper once and they will appear here.