{
  "openapi": "3.0.1",
  "info": {
    "title": "Bayut Scraper: UAE Property Listings, Prices & Contacts",
    "description": "$0.55–$0.75/1K listings + start fee · 0 proxy fees · 90-day DLD sold benchmarks. Scrape Bayut sale, rent, off-plan & commercial listings across Dubai & Abu Dhabi. Get AED prices, Golden Visa 2M+ AED flags, TruBroker badges, payment plans & direct agent contacts in 91 flat columns.",
    "version": "0.1",
    "x-build-id": "jLjqF6SDh30nNZu2k"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/kotaro001~bayut-com-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-kotaro001-bayut-com-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/kotaro001~bayut-com-scraper/runs": {
      "post": {
        "operationId": "runs-sync-kotaro001-bayut-com-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/kotaro001~bayut-com-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-kotaro001-bayut-com-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": {
          "listingType": {
            "title": "Listing type",
            "enum": [
              "buy",
              "rent",
              "commercial-buy",
              "commercial-rent"
            ],
            "type": "string",
            "description": "Market branch: `buy` (residential sales), `rent` (residential leases), `commercial-buy` (commercial property sales), or `commercial-rent` (commercial offices, retail and warehouses).",
            "default": "buy"
          },
          "rentFrequency": {
            "title": "Rent frequency",
            "enum": [
              "",
              "yearly",
              "monthly"
            ],
            "type": "string",
            "description": "For rental runs only: restrict to `yearly` or `monthly` lease terms. Leave empty for all rental frequencies.",
            "default": ""
          },
          "communities": {
            "title": "Communities",
            "type": "array",
            "description": "Target UAE communities (e.g., Dubai Marina, Downtown Dubai, Palm Jumeirah, Business Bay, JVC, Dubai Hills Estate, Al Reem Island, Yas Island, Saadiyat Island). The row budget is split evenly across selected areas.",
            "default": [
              "Dubai Marina"
            ],
            "items": {
              "type": "string"
            }
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Optional property categories: apartment, villa, townhouse, penthouse, duplex, office, retail, warehouse, land. Leave empty to extract all property types.",
            "items": {
              "type": "string",
              "enum": [
                "apartment",
                "villa",
                "townhouse",
                "penthouse",
                "duplex",
                "office",
                "retail",
                "warehouse",
                "land"
              ]
            },
            "default": []
          },
          "completionStatus": {
            "title": "Completion",
            "enum": [
              "all",
              "ready",
              "off_plan"
            ],
            "type": "string",
            "description": "Filter by construction phase: `all`, `ready` (completed properties), or `off_plan` (primary developments under construction).",
            "default": "all"
          },
          "furnishing": {
            "title": "Furnishing",
            "enum": [
              "all",
              "furnished",
              "unfurnished",
              "partly_furnished"
            ],
            "type": "string",
            "description": "Furnishing condition filter: `all`, `furnished` (turnkey holiday homes), `unfurnished`, or `partly_furnished`.",
            "default": "all"
          },
          "minPrice": {
            "title": "Min price (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum asking price or annual rent in AED. Listings without a numeric price figure are preserved."
          },
          "maxPrice": {
            "title": "Max price (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum asking price or annual rent in AED. Filters out properties exceeding this budget ceiling."
          },
          "minBedrooms": {
            "title": "Min bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum number of bedrooms required (0 = Studio)."
          },
          "maxBedrooms": {
            "title": "Max bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of bedrooms allowed."
          },
          "minBathrooms": {
            "title": "Min bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum number of bathrooms required."
          },
          "minAreaSqft": {
            "title": "Min area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum built-up area in square feet."
          },
          "maxAreaSqft": {
            "title": "Max area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum built-up area in square feet."
          },
          "minDaysOnMarket": {
            "title": "Min days on market",
            "type": "integer",
            "description": "Keep only listings advertised for at least this many days based on portal publication dates (0 = no filter). Useful for discovering motivated sellers.",
            "default": 0
          },
          "onlyPriceChanged": {
            "title": "Only price-reduced listings",
            "type": "boolean",
            "description": "Return only listings where the portal records a recent price drop. Ideal for sourcing discounted inventory.",
            "default": false
          },
          "onlyVerified": {
            "title": "Only verified listings",
            "type": "boolean",
            "description": "Return only verified listings with authenticated ownership documentation and official TruCheck verification.",
            "default": false
          },
          "goldenVisaOnly": {
            "title": "Golden visa eligible (2M+ AED)",
            "type": "boolean",
            "description": "Restrict results to properties priced at 2,000,000 AED or above, qualifying buyers for the UAE 10-year Golden Visa.",
            "default": false
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum listing records to output to your dataset.",
            "default": 20
          },
          "belowCommunityMedianPercent": {
            "title": "Below community median (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep rows whose price per sqft is at least this percent below the median of the same community and bedroom count (positive means cheaper, so 10 = 10%+ below median).",
            "default": 0
          },
          "newWithinDays": {
            "title": "Listed within (days)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only listings posted in the last N days (0 = disabled). Ideal for daily change detection feeds.",
            "default": 0
          },
          "stateKey": {
            "title": "Session ID / Change tracking slot",
            "type": "string",
            "description": "Optional session slot name for persistent price tracking & change detection. NOT an Apify API key or private password."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}