{
  "openapi": "3.0.1",
  "info": {
    "title": "Dubizzle Scraper - UAE Cars, Property & Classifieds",
    "description": "Scrape dubizzle UAE listings: used cars, property for rent and sale, commercial, land and classifieds. Filter by emirate, keyword, price, year, km, bedrooms and seller. Price, specs, photos, location, agency and dates. Paste dubizzle links too. onlyNew for alerts. Errors free.",
    "version": "0.1",
    "x-build-id": "lMJpeKvRfofuz5CQH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapewise~dubizzle-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapewise-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/scrapewise~dubizzle-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapewise-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/scrapewise~dubizzle-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapewise-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": {
          "category": {
            "title": "Category",
            "enum": [
              "used-cars",
              "motors",
              "motorcycles",
              "property-for-rent",
              "property-for-sale",
              "commercial-for-rent",
              "commercial-for-sale",
              "land-for-sale",
              "classifieds"
            ],
            "type": "string",
            "description": "What to search on dubizzle UAE. Ignored for the links you paste below (each link keeps its own category).",
            "default": "used-cars"
          },
          "city": {
            "title": "Emirate",
            "enum": [
              "all",
              "dubai",
              "abu-dhabi",
              "sharjah",
              "ajman",
              "ras-al-khaimah",
              "fujairah",
              "umm-al-quwain",
              "al-ain"
            ],
            "type": "string",
            "description": "Only listings in this emirate. All UAE by default.",
            "default": "all"
          },
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Optional free-text searches inside the category, one per line, for example land cruiser, marina 2 bedroom or iphone 15. Each keyword is one search. Empty = the whole category.",
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Min price (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or above this amount in UAE dirhams."
          },
          "maxPrice": {
            "title": "Max price (AED)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or below this amount in UAE dirhams (yearly rent for most rentals)."
          },
          "minYear": {
            "title": "Min year (cars)",
            "minimum": 1950,
            "maximum": 2030,
            "type": "integer",
            "description": "Motors only: model year from, for example 2020."
          },
          "maxYear": {
            "title": "Max year (cars)",
            "minimum": 1950,
            "maximum": 2030,
            "type": "integer",
            "description": "Motors only: model year up to."
          },
          "maxKilometers": {
            "title": "Max kilometers (cars)",
            "minimum": 0,
            "type": "integer",
            "description": "Motors only: mileage up to, for example 60000."
          },
          "minBedrooms": {
            "title": "Min bedrooms (property)",
            "minimum": 0,
            "maximum": 12,
            "type": "integer",
            "description": "Property only: at least this many bedrooms (0 = studios included)."
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "any",
              "dealer",
              "owner",
              "agent",
              "landlord"
            ],
            "type": "string",
            "description": "Motors: dealer or private owner. Property: agent or landlord. Any = all sellers.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "price_asc",
              "price_desc",
              "kilometers_asc",
              "year_desc"
            ],
            "type": "string",
            "description": "Order of the results, as on the site. onlyNew switches Relevance to Newest first.",
            "default": "relevance"
          },
          "startUrls": {
            "title": "dubizzle links",
            "type": "array",
            "description": "Optional: dubizzle UAE category links copied from the address bar, for example https://dubai.dubizzle.com/motors/used-cars/toyota/land-cruiser/ or https://abudhabi.dubizzle.com/property-for-rent/residential/apartmentflat/. The emirate comes from the link, and price, year, kilometers and bedroom filters in the link are kept.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap for the whole run, across all searches and links. 0 = no cap. One search returns up to 10,000 listings (a dubizzle limit); split big searches by emirate or price.",
            "default": 50
          },
          "onlyNew": {
            "title": "Only new listings (for schedules)",
            "type": "boolean",
            "description": "On: remembers the listings delivered in earlier runs of the same search (in your account) and delivers only listings not seen before. Skipped listings are free.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy by default. If dubizzle refuses it twice in a row, the Actor switches to residential by itself.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}