{ "openapi": "3.0.1", "info": { "title": "Dubizzle Property Scraper with Agents & Features", "description": "Extract Dubizzle UAE property listings with asking prices, descriptions, photos, amenities, locations, coordinates, and agent or agency details. Get pipeline-ready JSON, run summaries, and an interactive map for market research, inventory monitoring, CRM enrichment, and analytics.", "version": "0.1", "x-build-id": "YFi4UN2hlle9R8Wbt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~dubizzle-property-scraper-apify/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-dubizzle-property-scraper-apify", "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/fatihtahta~dubizzle-property-scraper-apify/runs": { "post": { "operationId": "runs-sync-fatihtahta-dubizzle-property-scraper-apify", "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/fatihtahta~dubizzle-property-scraper-apify/run-sync": { "post": { "operationId": "run-sync-fatihtahta-dubizzle-property-scraper-apify", "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": { "location": { "title": "Locations", "type": "array", "description": "Enter locations recognized by Dubizzle UAE, such as Dubai Marina, Downtown Dubai, Abu Dhabi, or Jumeirah Village Circle.", "items": { "type": "string" }, "default": [] }, "deal_type": { "title": "Deal Type", "enum": [ "sale", "rent" ], "type": "string", "description": "Choose whether to collect properties offered for sale or rent.", "default": "sale" }, "property_type": { "title": "Property Type", "enum": [ "residential", "apartment", "villa", "townhouse", "penthouse", "hotel_apartment", "residential_building", "residential_floor", "villa_compound", "commercial", "land", "multiple_units" ], "type": "string", "description": "Choose one property category. Land and multiple-unit searches are available for sale listings only.", "default": "residential" }, "min_price": { "title": "Minimum Price (AED)", "minimum": 0, "type": "integer", "description": "Only include listings at or above this displayed price." }, "max_price": { "title": "Maximum Price (AED)", "minimum": 0, "type": "integer", "description": "Only include listings at or below this displayed price." }, "min_floor_area": { "title": "Minimum Floor Area (sq ft)", "minimum": 0, "type": "integer", "description": "Only include properties with at least this floor area." }, "max_floor_area": { "title": "Maximum Floor Area (sq ft)", "minimum": 0, "type": "integer", "description": "Only include properties with no more than this floor area." }, "amenities": { "title": "Amenities", "uniqueItems": true, "type": "array", "description": "Select one or more required amenity filters.", "items": { "type": "string", "enum": [ "maids_room", "study", "central_a_c_heating", "balcony", "private_garden", "private_pool", "private_gym", "private_jacuzzi", "shared_pool", "shared_spa", "shared_gym", "security", "concierge_service", "maid_service", "covered_parking", "built_in_wardrobes", "walk_in_closet", "built_in_kitchen_appliances", "view_of_water", "view_of_landmark", "pets_allowed", "double_glazed_windows", "day_care_center", "electricity_backup", "first_aid_medical_center", "service_elevators", "prayer_room", "laundry_room", "broadband_internet", "satellite_cable_tv", "business_center", "intercom", "atm_facility", "kids_play_area", "reception_waiting_room", "maintenance_staff", "cctv_security", "cafeteria_canteen", "shared_kitchen", "facilities_for_disabled", "storage_areas", "cleaning_services", "barbeque_area", "lobby_in_building", "waste_disposal" ], "enumTitles": [ "Maids Room", "Study", "Central A/C & Heating", "Balcony", "Private Garden", "Private Pool", "Private Gym", "Private Jacuzzi", "Shared Pool", "Shared Spa", "Shared Gym", "Security", "Concierge Service", "Maid Service", "Covered Parking", "Built-in Wardrobes", "Walk-in Closet", "Built-in Kitchen Appliances", "View of Water", "View of Landmark", "Pets Allowed", "Double-glazed Windows", "Day Care Center", "Electricity Backup", "First Aid Medical Center", "Service Elevators", "Prayer Room", "Laundry Room", "Broadband Internet", "Satellite/Cable TV", "Business Center", "Intercom", "ATM Facility", "Kids Play Area", "Reception/Waiting Room", "Maintenance Staff", "CCTV Security", "Cafeteria/Canteen", "Shared Kitchen", "Facilities for Disabled", "Storage Areas", "Cleaning Services", "Barbeque Area", "Lobby in Building", "Waste Disposal" ] }, "default": [] }, "keyword": { "title": "Keyword", "type": "string", "description": "Search listing text for a word or phrase, such as lake view or vacant." }, "listed_by": { "title": "Listed By", "uniqueItems": true, "type": "array", "description": "Filter listings by the type of advertiser.", "items": { "type": "string", "enum": [ "agent", "landlord", "developer" ], "enumTitles": [ "Agent", "Landlord", "Developer" ] }, "default": [] }, "re_agency_name": { "title": "Real Estate Agency Name", "type": "string", "description": "Match listings from a specific real estate agency name." }, "bathroom_count": { "title": "Bathrooms", "uniqueItems": true, "type": "array", "description": "Select one or more bathroom counts. 6+ includes listings with six or more bathrooms.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6+" ], "enumTitles": [ "1", "2", "3", "4", "5", "6+" ] }, "default": [] }, "bedroom_count": { "title": "Bedrooms", "uniqueItems": true, "type": "array", "description": "Select one or more bedroom counts. Studio maps to zero bedrooms and 12+ includes listings with twelve or more.", "items": { "type": "string", "enum": [ "Studio", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12+" ], "enumTitles": [ "Studio", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12+" ] }, "default": [] }, "furnishment": { "title": "Furnishment", "enum": [ "furnished", "unfurnished" ], "type": "string", "description": "Filter by whether the property is furnished." }, "mutlimedia": { "title": "Multimedia", "uniqueItems": true, "type": "array", "description": "Only include listings that provide the selected media formats.", "items": { "type": "string", "enum": [ "video", "360_tour" ], "enumTitles": [ "Video", "360 Tour" ] }, "default": [] }, "completion_status": { "title": "Completion Status", "enum": [ "ready", "off_plan" ], "type": "string", "description": "Filter listings by ready or off-plan status." }, "sort_by": { "title": "Sort By", "enum": [ "default", "relevance", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "Choose how Dubizzle search results are ordered.", "default": "default" }, "enrich_data": { "title": "Add Richer Property, Media, History, and Contact Details", "type": "boolean", "description": "Keep this enabled to add fuller descriptions, photo galleries, property features and amenities, available price or tax history, and available agent or agency contact details. Turn it off for faster validation or monitoring runs when lightweight search-result fields are sufficient.", "default": true }, "limit": { "title": "Maximum Property Listings to Save", "minimum": 1, "type": "integer", "description": "Set the maximum number of listing records to save across this run. Leave empty for no user-defined cap." }, "mcpConnectors": { "title": "MCP Connectors for Run-Summary Delivery", "uniqueItems": true, "type": "array", "description": "Choose user-authorized connectors for optional post-run delivery. The full property dataset is not sent through MCP.", "default": [] } } }, "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 } } } } } } } } } }