{ "openapi": "3.0.1", "info": { "title": "Indian Property Listings Finder by City & BHK", "description": "Search sale and rental property listings across 31 Indian cities by BHK, property type, locality and price band, with area, poster identity and listing links for buyers, agents and researchers.", "version": "1.0", "x-build-id": "9lCmU3P2oSAmJd2ok" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~indian-property-listings-finder-by-city-and-bhk/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-indian-property-listings-finder-by-city-and-bhk", "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/dataspryva~indian-property-listings-finder-by-city-and-bhk/runs": { "post": { "operationId": "runs-sync-dataspryva-indian-property-listings-finder-by-city-and-bhk", "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/dataspryva~indian-property-listings-finder-by-city-and-bhk/run-sync": { "post": { "operationId": "run-sync-dataspryva-indian-property-listings-finder-by-city-and-bhk", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchForSale", "searchForRent", "searchProperties", "bySearchUrl", "byPropertyUrl" ], "type": "string", "description": "What to collect. Search by city and filters, paste MagicBricks search-result URLs, or paste property-detail URLs.", "default": "searchForSale" }, "startUrls": { "title": "Search or property URLs", "type": "array", "description": "MagicBricks search-result or property-detail links (mode=bySearchUrl or byPropertyUrl).", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "MagicBricks search-result or property-detail URL." } } }, "default": [] }, "city": { "title": "City", "enum": [ "Mangalore", "Belgaum", "Mysore", "Hubli", "Ahmedabad", "Bangalore", "Beyond Thane", "Chennai", "Gurgaon", "Hyderabad", "Indore", "Jaipur", "Kolkata", "Lucknow", "Mumbai", "Navi Mumbai", "New Delhi", "Noida", "Pune", "Thane", "Agra", "Ahmadnagar", "Allahabad", "Aluva", "Amritsar", "Aurangabad", "Badlapur", "Bareilly", "Bhiwadi", "Bhiwandi", "Bhopal", "Bhubaneswar", "Bokaro Steel City", "Chandigarh", "Chengalpattu", "Coimbatore", "Dehradun", "Durgapur", "Ernakulam", "Erode", "Faridabad", "Ghaziabad", "Goa", "Gorakhpur", "Greater Noida", "Guntur", "Guwahati", "Gwalior", "Haridwar", "Hosur", "Jabalpur", "Jalandhar", "Jammu", "Jamshedpur", "Jodhpur", "Kalyan", "Kannur", "Kanpur", "Khopoli", "Kochi", "Kodaikanal", "Kottayam", "Kozhikode", "Lonavala", "Ludhiana", "Madurai", "Mohali", "Nagpur", "Nainital", "Nanded", "Nashik", "Navsari", "Nellore", "Newtown", "Ooty", "Palakkad", "Palghar", "Panchkula", "Patiala", "Patna", "Pondicherry", "Raipur", "Rajahmundry", "Ranchi", "Salem", "Satara", "Shimla", "Siliguri", "Solapur", "Sonipat", "Surat", "Thanjavur", "Thrissur", "Tirunelveli", "Tirupati", "Tirupur", "Trichy", "Trivandrum", "Tumkur", "Udaipur", "Udupi", "Vadodara", "Vapi", "Varanasi", "Vijayawada", "Visakhapatnam", "Vrindavan", "Zirakpur" ], "type": "string", "description": "Indian city to search (mode=searchForSale, searchForRent, searchProperties).", "default": "Mumbai" }, "localities": { "title": "Localities", "type": "array", "description": "Optional locality or neighbourhood names inside the city (mode=searchForSale, searchForRent, searchProperties). One search is run per locality.", "items": { "type": "string" } }, "propertyType": { "title": "Property type", "enum": [ "Apartment", "Builder Floor", "Independent House", "Villa", "Plot", "Penthouse", "Studio Apartment", "Farm House", "Serviced Apartment", "Commercial Office", "Office in IT Park/SEZ", "Commercial Shop", "Commercial Showroom" ], "type": "string", "description": "Type of property to search (mode=searchForSale, searchForRent, searchProperties).", "default": "Apartment" }, "bedrooms": { "title": "Bedrooms (BHK)", "enum": [ "Any", "1", "2", "3", "4", "5+" ], "type": "string", "description": "Bedroom count. 5+ is sent as 5, the site's maximum (mode=searchForSale, searchForRent, searchProperties).", "default": "Any" }, "priceMin": { "title": "Minimum price (INR)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Lowest asking price in Indian Rupees (mode=searchForSale, searchForRent, searchProperties)." }, "priceMax": { "title": "Maximum price (INR)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Highest asking price in Indian Rupees (mode=searchForSale, searchForRent, searchProperties)." }, "areaMin": { "title": "Minimum area (sq.ft)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Smallest covered or carpet area in square feet (mode=searchForSale, searchForRent, searchProperties)." }, "areaMax": { "title": "Maximum area (sq.ft)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Largest covered or carpet area in square feet (mode=searchForSale, searchForRent, searchProperties)." }, "furnishing": { "title": "Furnishing", "enum": [ "Any", "Furnished", "Semi-Furnished", "Unfurnished" ], "type": "string", "description": "Furnishing state filter (mode=searchForSale, searchForRent, searchProperties).", "default": "Any" }, "possessionStatus": { "title": "Possession", "enum": [ "Any", "Ready to Move", "Under Construction" ], "type": "string", "description": "Ready-to-move or under-construction filter (mode=searchForSale, searchProperties).", "default": "Any" }, "postedSince": { "title": "Posted within", "enum": [ "Any", "1" ], "type": "string", "description": "Only listings posted in the last 24 hours (mode=searchForSale, searchForRent, searchProperties). MagicBricks does not expose wider server-side posting windows.", "default": "Any" }, "tenantType": { "title": "Tenant preference", "enum": [ "Any", "Bachelors", "Family" ], "type": "string", "description": "Who the landlord accepts (mode=searchForRent and rent searches in searchProperties). MagicBricks exposes Bachelors and Family server-side.", "default": "Any" }, "sortBy": { "title": "Sort by", "enum": [ "Relevance", "Price - Low to High", "Price - High to Low", "Most Recent", "Rate/sqft - Low to High", "Rate/sqft - High to Low" ], "type": "string", "description": "Order of search results (mode=searchForSale, searchForRent, searchProperties).", "default": "Relevance" }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on the number of property records returned.", "default": 50 }, "includeDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Also open each listing's detail page for project, developer, RERA, full address, GPS, amenities, deposit and maintenance data (search modes).", "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 } } } } } } } } } }