{
  "openapi": "3.0.1",
  "info": {
    "title": "Dubai Property Transactions & Rents (DLD) Scraper",
    "description": "Every Dubai property sale, mortgage, gift and Ejari rental contract from the Dubai Land Department open data. One clean row per deal with price per sqft, area, project, rooms and dates. Incremental 'only new' mode for daily monitoring.",
    "version": "1.0",
    "x-build-id": "qaFjCUFtwSpCsUaHH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ams3d~dubai-dld-transactions-rents/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ams3d-dubai-dld-transactions-rents",
        "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/ams3d~dubai-dld-transactions-rents/runs": {
      "post": {
        "operationId": "runs-sync-ams3d-dubai-dld-transactions-rents",
        "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/ams3d~dubai-dld-transactions-rents/run-sync": {
      "post": {
        "operationId": "run-sync-ams3d-dubai-dld-transactions-rents",
        "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": {
          "datasets": {
            "title": "What to collect",
            "type": "array",
            "description": "Which DLD registers to export. Sales = sale and pre-sale deals. Rents = Ejari rental contracts (new and renewals).",
            "items": {
              "type": "string",
              "enum": [
                "sales",
                "rents",
                "mortgages",
                "gifts"
              ],
              "enumTitles": [
                "Sales transactions",
                "Rental contracts (Ejari)",
                "Mortgages",
                "Gifts"
              ]
            },
            "default": [
              "sales"
            ]
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 1,
            "maximum": 366,
            "type": "integer",
            "description": "How many days to cover, ending today (or at 'To date'). Ignored when 'From date' is set.",
            "default": 7
          },
          "fromDate": {
            "title": "From date",
            "type": "string",
            "description": "Start date (YYYY-MM-DD). The DLD gateway serves the current calendar year only."
          },
          "toDate": {
            "title": "To date",
            "type": "string",
            "description": "End date (YYYY-MM-DD). Defaults to today."
          },
          "usage": {
            "title": "Property usage",
            "enum": [
              "all",
              "residential",
              "commercial",
              "other"
            ],
            "type": "string",
            "description": "Residential, commercial or other property usage.",
            "default": "all"
          },
          "offPlan": {
            "title": "Off-plan (sales only)",
            "enum": [
              "all",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Sales only: off-plan (pre-registration) deals, ready deals, or both.",
            "default": "all"
          },
          "freeHold": {
            "title": "Freehold",
            "enum": [
              "all",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Freehold, non-freehold, or both.",
            "default": "all"
          },
          "areaContains": {
            "title": "Area name contains",
            "type": "array",
            "description": "Keep only records whose area name contains any of these words, e.g. 'Marsi' for Marsa Dubai (Dubai Marina), 'Business Bay', 'Jumeirah Village Circle'.",
            "items": {
              "type": "string"
            }
          },
          "projectContains": {
            "title": "Project name contains",
            "type": "array",
            "description": "Keep only records whose project or master project contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "minValueAed": {
            "title": "Minimum value (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Sale value for transactions, annual rent for rental contracts."
          },
          "maxValueAed": {
            "title": "Maximum value (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Sale value for transactions, annual rent for rental contracts."
          },
          "rentDateType": {
            "title": "Rent date applies to",
            "enum": [
              "registration",
              "start",
              "end"
            ],
            "type": "string",
            "description": "Rents only: which contract date the date range applies to.",
            "default": "registration"
          },
          "onlyNew": {
            "title": "Only new records since last run",
            "type": "boolean",
            "description": "Turn on when running on a schedule: each run returns only deals not returned by previous runs.",
            "default": false
          },
          "maxItems": {
            "title": "Max records",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many records. 0 = no limit.",
            "default": 0
          },
          "includeArabic": {
            "title": "Include Arabic names",
            "type": "boolean",
            "description": "Adds Arabic area, project and procedure names.",
            "default": false
          },
          "includeRaw": {
            "title": "Include raw DLD columns",
            "type": "boolean",
            "description": "Adds every original DLD column under 'raw'.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}