{
  "openapi": "3.0.1",
  "info": {
    "title": "Dubizzle Scraper",
    "description": "[💰 $0.9 / 1K] Extract property, motors, and classifieds listings from Dubizzle across every UAE emirate. Paste any Dubizzle search URL or run a structured search by emirate, category, price range, and keyword. From $0.90 per 1,000 results.",
    "version": "1.1",
    "x-build-id": "fhBUt13564B0URjub"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~dubizzle-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-dubizzle-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/solidcode~dubizzle-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-dubizzle-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/solidcode~dubizzle-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-dubizzle-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": {
          "startUrls": {
            "title": "Dubizzle URLs",
            "type": "array",
            "description": "Paste one or more Dubizzle URLs — search results, individual listings, or short links (e.g., dubizzle.com/s/AbcXyz). The scraper auto-detects each page type and walks pagination. When provided, these override the structured search below.",
            "items": {
              "type": "string"
            }
          },
          "searchKeyword": {
            "title": "Search Keyword",
            "type": "string",
            "description": "Free-text search term, e.g. \"Toyota Corolla\", \"studio apartment\", \"iPhone 15\". Used only when Dubizzle URLs above is empty."
          },
          "emirate": {
            "title": "Emirate",
            "enum": [
              "dubai",
              "abu-dhabi",
              "sharjah",
              "ajman",
              "ras-al-khaimah",
              "fujairah",
              "umm-al-quwain",
              "al-ain"
            ],
            "type": "string",
            "description": "Which UAE emirate to search. Multi-word emirates use hyphens: abu-dhabi, ras-al-khaimah, umm-al-quwain, al-ain.",
            "default": "dubai"
          },
          "category": {
            "title": "Category",
            "enum": [
              "property-for-sale",
              "property-for-rent",
              "motors",
              "classifieds",
              "jobs"
            ],
            "type": "string",
            "description": "Which Dubizzle vertical to search.",
            "default": "property-for-sale"
          },
          "listingType": {
            "title": "Listing Type (optional)",
            "enum": [
              "property-for-sale/residential/apartment",
              "property-for-sale/residential/villahouse",
              "property-for-sale/residential/townhouse",
              "property-for-sale/residential/residential-building",
              "property-for-sale/residential/penthouse",
              "property-for-sale/residential/hotel-apartment",
              "property-for-sale/residential/villa-compound",
              "property-for-sale/residential/residential-floor",
              "property-for-rent/residential/apartmentflat",
              "property-for-rent/residential/villahouse",
              "property-for-rent/residential/townhouse",
              "property-for-rent/residential/hotel-apartment",
              "property-for-rent/residential/penthouse",
              "property-for-rent/residential/residential-building",
              "property-for-rent/residential/villa-compound",
              "property-for-rent/residential/residential-floor",
              "motors/used-cars",
              "motors/number-plates",
              "motors/rental-cars",
              "motors/auto-accessories-parts",
              "motors/motorcycles",
              "motors/heavy-vehicles",
              "motors/boats",
              "classified/furniture-home-garden",
              "classified/home-appliances",
              "classified/clothing-accessories",
              "classified/sports-equipment",
              "classified/mobile-phones-pdas",
              "classified/electronics",
              "classified/computers-networking",
              "classified/jewelry-watches",
              "classified/collectibles",
              "classified/gaming",
              "classified/baby-items",
              "classified/books",
              "classified/business-industrial",
              "classified/toys",
              "classified/cameras-imaging",
              "classified/musical-instruments",
              "classified/pets",
              "classified/free-stuff",
              "classified/music",
              "classified/tickets-vouchers",
              "classified/dvds-movies",
              "classified/lostfound",
              "jobs/sales-business-development",
              "jobs/accounting-finance",
              "jobs/driver-delivery",
              "jobs/manufacturing-warehouse",
              "jobs/engineering",
              "jobs/secretarial-front-office",
              "jobs/others",
              "jobs/cleaner-housekeeper",
              "jobs/real-estate",
              "jobs/construction",
              "jobs/hr-admin",
              "jobs/cook-chef",
              "jobs/handyman-technician",
              "jobs/restaurant-operations",
              "jobs/marketing-advertising",
              "jobs/automotive",
              "jobs/design",
              "jobs/customer-service-call-centre",
              "jobs/beauty-salon",
              "jobs/logistics-distribution",
              "jobs/data-management-analysis",
              "jobs/education",
              "jobs/information-technology",
              "jobs/media-art-entertainment",
              "jobs/medical-healthcare",
              "jobs/travel-hospitality",
              "jobs/event-management-operations",
              "jobs/sports-fitness",
              "jobs/legal-services",
              "jobs/security-guard",
              "jobs/marine-captain-crew"
            ],
            "type": "string",
            "description": "Narrow the search to a single listing type so you only pay for the listings you actually want. Choosing \"Motors — Used Cars\", for example, leaves out the rental cars, number plates and spare parts that a plain Motors search also returns. Leave this empty to search the whole category. Your choice sets the category for you, so there is no need to match the two by hand."
          },
          "priceMin": {
            "title": "Minimum Price (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings at or above this price in AED. Leave empty for no minimum."
          },
          "priceMax": {
            "title": "Maximum Price (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings at or below this price in AED. Leave empty for no maximum."
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "relevance",
              "newest",
              "oldest",
              "price-asc",
              "price-desc"
            ],
            "type": "string",
            "description": "How to order results. \"Oldest first\" and the price sorts are not available for Jobs — those searches come back in Dubizzle's default order instead.",
            "default": "relevance"
          },
          "language": {
            "title": "Language",
            "enum": [
              "en",
              "ar"
            ],
            "type": "string",
            "description": "Language for results. Dubizzle ships an English and an Arabic UI.",
            "default": "en"
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings to collect across all URLs and searches. Set to 0 for unlimited (safety-capped at 50,000). Note: a single search is limited to 10,000 results — to collect more, narrow your filters with priceMin / priceMax / category and re-run.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}