{ "openapi": "3.0.1", "info": { "title": "99acres Property Scraper", "description": "[💰 $1.8 / 1K] Extract property listings from 99acres.com — India's largest real estate portal. Search by city, transaction type, BHK, and budget, or paste search URLs directly. Returns prices, locations, specifications, photos, and RERA details for residential and commercial properties.", "version": "1.0", "x-build-id": "clesBeYhcXSWOH2Xc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~99acres-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-99acres-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~99acres-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-99acres-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~99acres-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-99acres-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": "99acres Search URLs", "type": "array", "description": "Paste one or more 99acres search-result URLs (e.g. https://www.99acres.com/property-in-mumbai-ffid). Filters in the URL are honored as-is. When provided, the structured filters below are ignored.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "City to search in (e.g. \"Mumbai\", \"Bangalore\", \"Delhi\", \"Pune\", \"Hyderabad\"). Ignored when Search URLs are provided.", "default": "Mumbai" }, "transactionType": { "title": "Transaction Type", "enum": [ "buy", "rent", "pg", "new-launches", "commercial-buy", "commercial-rent" ], "type": "string", "description": "What kind of listings to collect.", "default": "buy" }, "propertyType": { "title": "Property Type", "enum": [ "apartment", "independent-house", "villa", "builder-floor", "studio-apartment", "plot", "farmhouse", "office", "retail-shop", "warehouse" ], "type": "string", "description": "Type of property to look for. Leave blank to include all property types." }, "bedroomsMin": { "title": "Minimum Bedrooms (BHK)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Only include properties with at least this many bedrooms. Leave empty for any. Ignored for Plot, Commercial, and PG searches." }, "priceMinInr": { "title": "Minimum Price (₹)", "minimum": 0, "type": "integer", "description": "Target minimum price in Indian rupees (e.g. 5000000 for ₹50 lakh, 10000000 for ₹1 crore). Best-effort filter applied locally — 99acres' server-side budget params are unreliable. To reach your target maxResults, the actor over-fetches up to 3× and trims afterward. Rows without parsable INR price (e.g. \"On Request\", \"Call for price\") pass through unfiltered. Leave empty for no minimum." }, "priceMaxInr": { "title": "Maximum Price (₹)", "minimum": 0, "type": "integer", "description": "Target maximum price in Indian rupees. Best-effort filter applied locally — 99acres' server-side budget params are unreliable. To reach your target maxResults, the actor over-fetches up to 3× and trims afterward. Rows without parsable INR price pass through unfiltered. Leave empty for no maximum." }, "localities": { "title": "Localities", "type": "array", "description": "Optional locality names to narrow within the city (e.g. \"Bandra West\", \"Whitefield\", \"Gurgaon Sector 49\"). Leave empty to search the whole city.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of property rows to collect across all searches. Default 200 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 50,000 still applies). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots.", "default": 200 } } }, "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 } } } } } } } } } }