# Bayut Property Scraper (`one-api/bayut-property-scraper`) Actor

Scrape Bayut.com UAE listings, property details, agency / agent / truBroker lookups, claimed-deals stats, agent stories, and location autocomplete in real time. Search by city or neighbourhood externalID with full filters (purpose, completion status, price, beds, baths, area).

- **URL**: https://apify.com/one-api/bayut-property-scraper.md
- **Developed by:** [ONE API](https://apify.com/one-api) (community)
- **Categories:** Lead generation, Real estate
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Bayut.com Property Scraper

Scrape **Bayut.com** UAE property listings (Dubai, Abu Dhabi, Sharjah, Ajman, RAK, Fujairah, UAQ), full property details, agency / agent / truBroker lookups, claimed-deals stats, agent stories, and location autocomplete — all from one Actor. Backed by [realtyapi.io](https://realtyapi.io)'s real-time Bayut API.

⭐️ Found this useful? Please leave 5 stars! Issues / requests: 📬 **oneapi.project@gmail.com**

---

### What you can do

| Section | What it does | Input format |
|---|---|---|
| 🏠 **Property Details** | Full details for a specific listing | `externalID` digits, Bayut listing URL, or `details_NNN` slug — auto-detected per row |
| 🔎 **Search Listings** | Paginated UAE property search with full filter set | location externalID (e.g. `5002` for Dubai), Bayut slug, or Bayut search URL |
| 🔍 **Autocomplete** | Location lookup: cities, neighbourhoods, sub-communities, towers | partial query string (`dubai marina`, `palm jumeirah`) |
| 🏢 **Agency Details** | Full agency profile by externalID | digits |
| 👤 **Agents under an Agency** | All agents at one agency, with their slugs | agency externalID |
| 👤 **Agent Details** | Full agent profile with listing counts | agent slug `<name>-<externalID>` |
| ⭐ **TruBroker Agents** | Top-ranked agents in a location | location externalID |
| 📖 **Agent Stories** | Recent posts/updates an agent has published | agent externalID |
| 💰 **Agent Claimed Deals** | Lifetime deal count + total transaction price (For Sale, For Rent, Wanted) | agent externalID |

You can fill any combination of sections in a single run — leave the others empty.

---

### Output

Each listing / agent / agency / story / autocomplete suggestion is pushed as **one dataset row**, flattened to friendly columns plus a `Raw` column with the original JSON.

| Mode | External ID | Status | Price (AED) | Beds | Baths | Sqft | Type | Completion | City | Community | Agency |
|---|---|---|---|---|---|---|---|---|---|---|---|
| `search/byid` | 11602994 | active | 15599999 | 5 | 7 | 8612 | Villas | under-construction | Dubai | The Oasis by Emaar | Hills Field Real Estate |
| `details/property` | 15062791 | active | 15599999 | 5 | 7 | 8612 | Villas | under-construction | Dubai | The Oasis by Emaar | Hills Field Real Estate |
| `autocomplete` | 5002 | — | — | — | — | — | location | — | Dubai | — | — |
| `trubroker/byid` | 2099259 | rank 18 | — | 47 | 12 | — | — | — | Dubai | — | — |

Plus: `Reference Number`, `Title`, `Purpose`, `Rent Frequency`, `Plot Area Sqft`, `Permit Number`, `Furnishing`, `Verified`, `Sub Community`, `Latitude`, `Longitude`, `Created At`, `Updated At`, `Photo` (cover URL), `Photo Count`, `Panorama Count`, `Video Count`, `Agent ID`, `Agent Name`, `Phone`, `WhatsApp`, `Listing URL`.

For nested fields (full photo arrays, panoramas, payment plans, amenities, completion details, multi-language titles), the complete upstream JSON is in the `Raw` column.

> **Area note**: Bayut's API returns `area` in **square metres**. The `Area Sqft` and `Plot Area Sqft` columns are converted to sqft for you. The `areaSqftRange` filter is also taken in sqft and converted before sending.

---

### Sample input

```json
{
    "property_inputs": [
        "15062791",
        "https://www.bayut.com/property/details_15062791.html"
    ],
    "search_inputs": ["5002", "dubai-marina"],
    "purpose": "for-sale",
    "category": "residential",
    "completionStatus": "completed",
    "priceRange": "min:1000000,max:5000000",
    "beds": "3",
    "areaSqftRange": "min:1500",
    "pages": 2,

    "autocomplete_inputs": ["dubai marina"],
    "agency_inputs": ["10499"],
    "agency_agents_inputs": ["10499"],
    "agent_inputs": ["salma-mohamed-mahmoud-hashem-2521536"],
    "trubroker_inputs": ["6901"],
    "stories_inputs": ["2510010"],
    "claimeddeals_inputs": ["1919589"]
}
````

***

### Search filters (apply to every `search_inputs` row)

- **purpose** — `for-sale` (default) or `for-rent`.
- **category** — `residential` (default) or `commercial`.
- **completionStatus** — `completed` (ready), `under-construction` (off-plan), or empty (any).
- **priceRange** — `min:X` | `max:Y` | `min:X,max:Y` in AED.
- **beds, baths** — exact integer match (Bayut's API only accepts a single value, not a range). For studios use `0`.
- **areaSqftRange** — `min:X` | `max:Y` | `min:X,max:Y` in sqft (we convert to sqm internally).
- **furnishingStatus** — `furnished`, `unfurnished`, `partly-furnished`, or empty (any).
- **rentFrequency** — `yearly`, `monthly`, `weekly`, `daily` (used only when `purpose=for-rent`).
- **hasPanorama, hasVideo, hasFloorplan** — booleans, true = listings with that asset only.
- **agency\_external\_ids** — comma list (e.g. `10499,29599755`) — restrict to those agencies.
- **hitsPerPage** — 1–25 (Bayut's max page size). Default 25.
- **pages** — pages to fetch per query (1–50). Bayut deep pagination caps around 40 pages.

***

### Pricing

**Pay per result** — $3 per 1,000 items pushed. Failed inputs return a row with `Status: ERROR: ...` and are billed the same as a successful row.

To cap spend, set `Max paid dataset items` on the run page.

***

### Tips

- **Need just one property?** Use `property_inputs` — auto-detects externalID, URL, or `details_NNN` slug.
- **Pull all listings in a city?** Use `search_inputs: ["5002"]` (Dubai) with `pages: 5` for ~125 listings; `5002`=Dubai, `6020`=Abu Dhabi, `6901`=Sharjah, `5891`=Ajman, `7008`=RAK.
- **Don't know the location externalID?** Run `autocomplete_inputs` first with the area name (e.g. `dubai marina`) — the first result's `External ID` is what you want.
- **Find every agent at an agency?** Use `agency_agents_inputs: ["<agencyID>"]` — returns each agent with their slug, ready to drop into `agent_inputs`.
- **Off-plan only?** Set `completionStatus: "under-construction"`.
- **Top agents in a city?** Use `trubroker_inputs: ["5002"]` with `purpose=for-sale, completionStatus=completed`.
- **Resolve a Bayut search URL?** Drop the URL into `search_inputs` — we extract the location slug and resolve via autocomplete.

# Actor input Schema

## `property_inputs` (type: `array`):

Auto-detects each entry: digits → externalID, http(s) URL → Bayut listing URL (we extract the externalID), `details_NNN` slug → externalID. Each row = 1 property detail call.

## `search_inputs` (type: `array`):

Auto-detects each entry. Examples:
• `5002` (Dubai externalID — get from /autocomplete)
• `6020` (Abu Dhabi), `6901` (Sharjah)
• `dubai-marina` (slug — we resolve via /autocomplete)
• `https://www.bayut.com/to-rent/property/dubai/` (Bayut URL — we resolve)

Filters below apply to every search. Each LISTING is pushed as one dataset item.

## `purpose` (type: `string`):

for-sale (default) or for-rent.

## `category` (type: `string`):

Top-level category. Defaults to residential.

## `completionStatus` (type: `string`):

Bayut filter: `completed` (ready), `under-construction` (off-plan), or empty (any).

## `priceRange` (type: `string`):

`min:500000`, `max:5000000`, or `min:500000,max:5000000`.

## `beds` (type: `string`):

Bayut filters by exact bed count (e.g. `2`, `5`). Empty = any. Bayut's range filter uses single values only — for studio enter `0`.

## `baths` (type: `string`):

Exact bath count (e.g. `2`). Empty = any.

## `areaSqftRange` (type: `string`):

`min:800`, `max:3000`, `min:800,max:3000`. Bayut's API works in sqm — we convert sqft→sqm automatically.

## `furnishingStatus` (type: `string`):

Bayut furnishing filter. Empty = any.

## `rentFrequency` (type: `string`):

Used when `purpose` = `for-rent`. Yearly is most common in the UAE.

## `hasPanorama` (type: `boolean`):

Only listings with at least one 360° panorama image.

## `hasVideo` (type: `boolean`):

Only listings with at least one video tour.

## `hasFloorplan` (type: `boolean`):

Only listings with a floor plan attached.

## `agency_external_ids` (type: `string`):

Restrict to listings owned by one or more agencies. e.g. `10499,29599755`.

## `hitsPerPage` (type: `integer`):

Bayut allows up to 25 listings per page (default).

## `pages` (type: `integer`):

Each page = up to 25 listings. Bayut caps deep pagination — typical max useful depth is ~40 pages.

## `autocomplete_inputs` (type: `array`):

Bayut location lookup: cities, neighbourhoods, sub-communities, towers. Use the resulting `externalID` as `search_inputs`.

## `agency_inputs` (type: `array`):

Get the full agency profile (name, agents count, license number, phone). The agency `externalID` is shown as `Agency ID` in any search row.

## `agency_agents_inputs` (type: `array`):

Returns every agent registered under this agency, with their own externalID + slug for use in the Agent Details section.

## `agent_inputs` (type: `array`):

Agent slug — find it from any search row's `ownerAgent.externalID` looked up via `agency_agents_inputs`, or directly from the Bayut.com agent profile URL. Format: `<name>-<externalID>`.

## `trubroker_inputs` (type: `array`):

Bayut's top-ranked agents in a location, with badges (truBroker, responsive, quality lister). Same format as `search_inputs` — use a location externalID. Honours `purpose`, `category`, `completionStatus`.

## `stories_inputs` (type: `array`):

Recent updates / posts an agent has published on Bayut. Pass agent `externalID` (digits, e.g. `2510010`).

## `claimeddeals_inputs` (type: `array`):

Lifetime closed-deal stats per agent: count of pending/rejected/approved deals (For Sale, For Rent, Wanted) and their total transaction value in AED. Returns 2 dataset rows per agent (one for /count, one for /totalPrice).

## Actor input object example

```json
{
  "property_inputs": [
    "15062791",
    "https://www.bayut.com/property/details_15062791.html"
  ],
  "search_inputs": [
    "5002"
  ],
  "purpose": "for-sale",
  "category": "residential",
  "completionStatus": "",
  "priceRange": "",
  "beds": "",
  "baths": "",
  "areaSqftRange": "",
  "furnishingStatus": "",
  "rentFrequency": "",
  "hasPanorama": false,
  "hasVideo": false,
  "hasFloorplan": false,
  "agency_external_ids": "",
  "hitsPerPage": 25,
  "pages": 1
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "property_inputs": [
        "15062791",
        "https://www.bayut.com/property/details_15062791.html"
    ],
    "search_inputs": [
        "5002"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("one-api/bayut-property-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "property_inputs": [
        "15062791",
        "https://www.bayut.com/property/details_15062791.html",
    ],
    "search_inputs": ["5002"],
}

# Run the Actor and wait for it to finish
run = client.actor("one-api/bayut-property-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "property_inputs": [
    "15062791",
    "https://www.bayut.com/property/details_15062791.html"
  ],
  "search_inputs": [
    "5002"
  ]
}' |
apify call one-api/bayut-property-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=one-api/bayut-property-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Bayut Property Scraper",
        "description": "Scrape Bayut.com UAE listings, property details, agency / agent / truBroker lookups, claimed-deals stats, agent stories, and location autocomplete in real time. Search by city or neighbourhood externalID with full filters (purpose, completion status, price, beds, baths, area).",
        "version": "1.0",
        "x-build-id": "M5kewe0Sl0FjeRfvS"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/one-api~bayut-property-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-one-api-bayut-property-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/one-api~bayut-property-scraper/runs": {
            "post": {
                "operationId": "runs-sync-one-api-bayut-property-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/one-api~bayut-property-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-one-api-bayut-property-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "property_inputs": {
                        "title": "Property externalID, Bayut URL, or details_NNN slug (one per line)",
                        "type": "array",
                        "description": "Auto-detects each entry: digits → externalID, http(s) URL → Bayut listing URL (we extract the externalID), `details_NNN` slug → externalID. Each row = 1 property detail call.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "search_inputs": {
                        "title": "Location externalID or Bayut location slug (one per line)",
                        "type": "array",
                        "description": "Auto-detects each entry. Examples:\n• `5002` (Dubai externalID — get from /autocomplete)\n• `6020` (Abu Dhabi), `6901` (Sharjah)\n• `dubai-marina` (slug — we resolve via /autocomplete)\n• `https://www.bayut.com/to-rent/property/dubai/` (Bayut URL — we resolve)\n\nFilters below apply to every search. Each LISTING is pushed as one dataset item.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "purpose": {
                        "title": "Purpose",
                        "enum": [
                            "for-sale",
                            "for-rent"
                        ],
                        "type": "string",
                        "description": "for-sale (default) or for-rent.",
                        "default": "for-sale"
                    },
                    "category": {
                        "title": "Category",
                        "enum": [
                            "residential",
                            "commercial"
                        ],
                        "type": "string",
                        "description": "Top-level category. Defaults to residential.",
                        "default": "residential"
                    },
                    "completionStatus": {
                        "title": "Completion Status",
                        "enum": [
                            "",
                            "completed",
                            "under-construction"
                        ],
                        "type": "string",
                        "description": "Bayut filter: `completed` (ready), `under-construction` (off-plan), or empty (any).",
                        "default": ""
                    },
                    "priceRange": {
                        "title": "Price Range (AED)",
                        "type": "string",
                        "description": "`min:500000`, `max:5000000`, or `min:500000,max:5000000`.",
                        "default": ""
                    },
                    "beds": {
                        "title": "Beds (exact)",
                        "type": "string",
                        "description": "Bayut filters by exact bed count (e.g. `2`, `5`). Empty = any. Bayut's range filter uses single values only — for studio enter `0`.",
                        "default": ""
                    },
                    "baths": {
                        "title": "Baths (exact)",
                        "type": "string",
                        "description": "Exact bath count (e.g. `2`). Empty = any.",
                        "default": ""
                    },
                    "areaSqftRange": {
                        "title": "Area Range (sqft)",
                        "type": "string",
                        "description": "`min:800`, `max:3000`, `min:800,max:3000`. Bayut's API works in sqm — we convert sqft→sqm automatically.",
                        "default": ""
                    },
                    "furnishingStatus": {
                        "title": "Furnishing",
                        "enum": [
                            "",
                            "furnished",
                            "unfurnished",
                            "partly-furnished"
                        ],
                        "type": "string",
                        "description": "Bayut furnishing filter. Empty = any.",
                        "default": ""
                    },
                    "rentFrequency": {
                        "title": "Rent Frequency (rent only)",
                        "enum": [
                            "",
                            "yearly",
                            "monthly",
                            "weekly",
                            "daily"
                        ],
                        "type": "string",
                        "description": "Used when `purpose` = `for-rent`. Yearly is most common in the UAE.",
                        "default": ""
                    },
                    "hasPanorama": {
                        "title": "Has 360° Panorama",
                        "type": "boolean",
                        "description": "Only listings with at least one 360° panorama image.",
                        "default": false
                    },
                    "hasVideo": {
                        "title": "Has Video Tour",
                        "type": "boolean",
                        "description": "Only listings with at least one video tour.",
                        "default": false
                    },
                    "hasFloorplan": {
                        "title": "Has Floor Plan",
                        "type": "boolean",
                        "description": "Only listings with a floor plan attached.",
                        "default": false
                    },
                    "agency_external_ids": {
                        "title": "Filter by Agency externalIDs (comma-separated)",
                        "type": "string",
                        "description": "Restrict to listings owned by one or more agencies. e.g. `10499,29599755`.",
                        "default": ""
                    },
                    "hitsPerPage": {
                        "title": "Listings per page",
                        "minimum": 1,
                        "maximum": 25,
                        "type": "integer",
                        "description": "Bayut allows up to 25 listings per page (default).",
                        "default": 25
                    },
                    "pages": {
                        "title": "Pages to fetch per search",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Each page = up to 25 listings. Bayut caps deep pagination — typical max useful depth is ~40 pages.",
                        "default": 1
                    },
                    "autocomplete_inputs": {
                        "title": "Autocomplete query (one per line)",
                        "type": "array",
                        "description": "Bayut location lookup: cities, neighbourhoods, sub-communities, towers. Use the resulting `externalID` as `search_inputs`.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "agency_inputs": {
                        "title": "Agency externalID (one per line)",
                        "type": "array",
                        "description": "Get the full agency profile (name, agents count, license number, phone). The agency `externalID` is shown as `Agency ID` in any search row.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "agency_agents_inputs": {
                        "title": "Agency externalID — list its agents (one per line)",
                        "type": "array",
                        "description": "Returns every agent registered under this agency, with their own externalID + slug for use in the Agent Details section.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "agent_inputs": {
                        "title": "Agent slug, e.g. `salma-mohamed-mahmoud-hashem-2521536` (one per line)",
                        "type": "array",
                        "description": "Agent slug — find it from any search row's `ownerAgent.externalID` looked up via `agency_agents_inputs`, or directly from the Bayut.com agent profile URL. Format: `<name>-<externalID>`.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "trubroker_inputs": {
                        "title": "Location externalID for truBroker leaderboard (one per line)",
                        "type": "array",
                        "description": "Bayut's top-ranked agents in a location, with badges (truBroker, responsive, quality lister). Same format as `search_inputs` — use a location externalID. Honours `purpose`, `category`, `completionStatus`.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "stories_inputs": {
                        "title": "Agent externalID for stories (one per line)",
                        "type": "array",
                        "description": "Recent updates / posts an agent has published on Bayut. Pass agent `externalID` (digits, e.g. `2510010`).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "claimeddeals_inputs": {
                        "title": "Agent externalID for claimed-deals stats (one per line)",
                        "type": "array",
                        "description": "Lifetime closed-deal stats per agent: count of pending/rejected/approved deals (For Sale, For Rent, Wanted) and their total transaction value in AED. Returns 2 dataset rows per agent (one for /count, one for /totalPrice).",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
