{ "openapi": "3.0.1", "info": { "title": "MagicBricks Scraper [Only $1/1k] | Price Monitoring | RERA Data", "description": "Extract structured residential property listings from MagicBricks.com, India's largest property portal. Get price in INR, BHK, area, locality, GPS, RERA ID, developer and agent details. No browser or API key needed. 27+ cities incl. Bangalore, Mumbai, Delhi NCR, Hyderabad. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "gblt5WPxTWVOfhqgx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~magicbricks-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-magicbricks-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/ahmed_jasarevic~magicbricks-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-magicbricks-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/ahmed_jasarevic~magicbricks-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-magicbricks-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "MagicBricks search-result URLs (copy from the site after applying filters). The actor extracts the internal JSON API from each page, so any city works. Max 10 per run.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "city": { "title": "City", "type": "string", "description": "City name (Bangalore, Mumbai) or numeric MagicBricks city code (3327 = Bangalore, 4320 = Mumbai). Ignored when Search URLs are provided.", "default": "Bangalore" }, "searchMode": { "title": "Buy or rent", "enum": [ "buy", "rent" ], "type": "string", "description": "Whether to scrape for-sale (buy) or for-rent listings.", "default": "buy" }, "bhk": { "title": "BHK filter", "type": "array", "description": "Bedroom counts to keep (e.g. [2, 3]). Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] }, "default": [] }, "propertyType": { "title": "Property type", "type": "array", "description": "Property types to keep. Empty = all.", "items": { "type": "string", "enum": [ "apartment", "builder-floor", "penthouse", "residential-house", "villa", "residential-land", "studio", "farm-house" ] }, "default": [] }, "minPrice": { "title": "Min price (INR)", "minimum": 0, "type": "integer", "description": "Minimum price in INR (total for buy, monthly rent for rent). 0 = no minimum.", "default": 0 }, "maxPrice": { "title": "Max price (INR)", "minimum": 0, "type": "integer", "description": "Maximum price in INR. 0 = no maximum.", "default": 0 }, "minArea": { "title": "Min area (sq ft)", "minimum": 0, "type": "integer", "description": "Minimum carpet/built-up area in sq ft. 0 = no minimum.", "default": 0 }, "maxArea": { "title": "Max area (sq ft)", "minimum": 0, "type": "integer", "description": "Maximum carpet/built-up area in sq ft. 0 = no maximum.", "default": 0 }, "localities": { "title": "Localities", "type": "array", "description": "Keep only listings whose locality contains one of these names (case-insensitive). Empty = whole city.", "items": { "type": "string" }, "default": [] }, "furnishing": { "title": "Furnishing", "type": "array", "description": "Furnishing statuses to keep (rent listings mainly). Empty = all.", "items": { "type": "string", "enum": [ "furnished", "semi-furnished", "unfurnished" ] }, "default": [] }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum listings to return. Free-plan runs are capped at a 10-item preview.", "default": 30 }, "sortBy": { "title": "Sort by", "enum": [ "premiumRecent", "price-asc", "price-desc", "date-desc" ], "type": "string", "description": "Result ordering used by the MagicBricks search API.", "default": "premiumRecent" }, "maxRequestsPerCrawl": { "title": "Max Requests per Crawl", "minimum": 5, "maximum": 150, "type": "integer", "description": "Hard cap on HTTP requests for this run (loop safety).", "default": 60 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "MagicBricks is Akamai-protected: use Apify Proxy with an Indian residential group.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } } }, "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 } } } } } } } } } }