{
  "openapi": "3.0.1",
  "info": {
    "title": "Dubizzle Scraper — Property, Cars & Brokers",
    "description": "Scrape public Dubizzle UAE property and car searches, enrich listing detail pages, or collect property broker profiles. Returns normalized records for market research and lead qualification. Not for private, authenticated, or messaging data. Search records cost $0.004; detail records cost $0.012.",
    "version": "1.0",
    "x-build-id": "EJbfLqofInjDDWjzF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/muhammadafzal~dubizzle-search-detail-brokers/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-muhammadafzal-dubizzle-search-detail-brokers",
        "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/muhammadafzal~dubizzle-search-detail-brokers/runs": {
      "post": {
        "operationId": "runs-sync-muhammadafzal-dubizzle-search-detail-brokers",
        "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/muhammadafzal~dubizzle-search-detail-brokers/run-sync": {
      "post": {
        "operationId": "run-sync-muhammadafzal-dubizzle-search-detail-brokers",
        "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": {
          "mode": {
            "title": "Operation mode",
            "enum": [
              "search",
              "details",
              "brokers"
            ],
            "type": "string",
            "description": "Use this when choosing between search pages, individual listing details, or property brokers. Accepted values are search, details, and brokers; for example, details enriches direct listing URLs. Defaults to search. This is not a Dubizzle category filter.",
            "default": "search"
          },
          "startUrls": {
            "title": "Dubizzle URLs",
            "type": "array",
            "description": "Use this when you already have Dubizzle search, listing, or property-agent URLs. Add full public HTTPS URLs such as https://dubai.dubizzle.com/en/motors/used-cars/. Defaults to an empty list, which builds a search or brokers URL from the fields below. This field does not accept Bayut or Property Finder URLs.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "location": {
            "title": "UAE location",
            "enum": [
              "uae",
              "dubai",
              "abu-dhabi",
              "sharjah",
              "ajman",
              "ras-al-khaimah",
              "fujairah",
              "umm-al-quwain",
              "al-ain"
            ],
            "type": "string",
            "description": "Use this when structured search mode should target one UAE emirate or the national site. Select a slug such as dubai or abu-dhabi. Defaults to dubai. This field is ignored when Dubizzle URLs are supplied.",
            "default": "dubai"
          },
          "section": {
            "title": "Listing section",
            "enum": [
              "property-for-sale",
              "property-for-rent",
              "motors"
            ],
            "type": "string",
            "description": "Use this when structured search mode should collect sale property, rental property, or used cars. Accepted values include property-for-sale and motors; for example, motors builds the used-cars search. Defaults to property-for-sale. This is not used by details or brokers mode.",
            "default": "property-for-sale"
          },
          "propertyType": {
            "title": "Property path",
            "type": "string",
            "description": "Use this when structured property search needs a Dubizzle path segment. Enter a path such as residential, residential/apartment, or commercial. Defaults to residential. This field is ignored for motors, direct URLs, details, and brokers.",
            "default": "residential"
          },
          "searchQuery": {
            "title": "Search keywords",
            "type": "string",
            "description": "Use this when structured search should include free-text keywords. Enter plain text such as Toyota Corolla or Dubai Marina. Defaults to an empty string, meaning no keyword restriction. This is not a full Dubizzle URL.",
            "default": ""
          },
          "maxResults": {
            "title": "Maximum records",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Use this to cap dataset records and record-event charges. Enter an integer from 1 to 1000; for example, 20 limits the run to twenty rows. Defaults to 20. This is a run-wide cap, not a per-page limit.",
            "default": 20
          },
          "maxPages": {
            "title": "Maximum search pages",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Use this to cap pagination for search and broker directories. Enter an integer from 1 to 100; for example, 5 visits at most five result pages. Defaults to 5. This does not limit direct detail URLs.",
            "default": 5
          },
          "fetchDetails": {
            "title": "Enrich each result",
            "type": "boolean",
            "description": "Use this when search or broker rows need fields available only on profile/detail pages. Enable it to visit each result URL; a detail-result costs $0.012 instead of the $0.004 search-result. Defaults to false for faster automated health checks. This does not change details mode, which always extracts detail pages.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}