{ "openapi": "3.0.1", "info": { "title": "99acres City & BHK Property Listing Scraper", "description": "Search 99acres by city, BHK size, property type, locality, and price range to get structured buy and rent listings across 25 major Indian cities, with price, area, location, and poster details.", "version": "1.0", "x-build-id": "GfLPEtbM3CuOX9T6U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~99acres-city-and-bhk-property-listing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-99acres-city-and-bhk-property-listing-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/dataspryva~99acres-city-and-bhk-property-listing-scraper/runs": { "post": { "operationId": "runs-sync-dataspryva-99acres-city-and-bhk-property-listing-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/dataspryva~99acres-city-and-bhk-property-listing-scraper/run-sync": { "post": { "operationId": "run-sync-dataspryva-99acres-city-and-bhk-property-listing-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", "required": [ "mode", "city" ], "properties": { "mode": { "title": "Listing type", "type": "string", "description": "Search properties for sale or for rent.", "default": "searchForSale" }, "city": { "title": "City", "enum": [ "Delhi", "Mumbai", "Bangalore", "Hyderabad", "Chennai", "Kolkata", "Pune", "Ahmedabad", "Jaipur", "Noida", "Gurugram", "Navi Mumbai", "Thane", "Ghaziabad", "Faridabad", "Lucknow", "Surat", "Indore", "Bhopal", "Nagpur", "Vadodara", "Chandigarh", "Coimbatore", "Kochi", "Visakhapatnam" ], "type": "string", "description": "Indian city to search in.", "default": "Delhi" }, "propertyType": { "title": "Property type", "type": "string", "description": "Residential property type to search for.", "default": "Residential Apartment" }, "bedrooms": { "title": "Bedrooms (BHK)", "enum": [ "", "1", "2", "3", "4", "5+" ], "type": "string", "description": "Number of bedrooms. Choose '5+' for five or more.", "default": "" }, "locality": { "title": "Locality", "type": "string", "description": "Optional locality or sector name within the city, e.g. 'Sector 43'. The actor looks up the 99acres locality ID." }, "localities": { "title": "Localities (multiple)", "type": "array", "description": "Optional list of locality names; each is resolved to a 99acres locality ID.", "items": { "type": "string" } }, "priceMin": { "title": "Min price (INR)", "minimum": 0, "maximum": 999999999, "type": "integer", "description": "Minimum price in Indian Rupees. Applied while scanning pages because 99acres ignores price query parameters." }, "priceMax": { "title": "Max price (INR)", "minimum": 0, "maximum": 999999999, "type": "integer", "description": "Maximum price in Indian Rupees. Applied while scanning pages because 99acres ignores price query parameters." }, "furnishing": { "title": "Furnishing", "enum": [ "", "Furnished", "Unfurnished", "Semi-furnished" ], "type": "string", "description": "Filter by furnishing status.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest" ], "type": "string", "description": "Result order. 'Newest' is 99acres' recently-updated order (updatedAt), not the original posting date (postedAt).", "default": "relevance" }, "includeProjects": { "title": "Include new-launch projects", "type": "boolean", "description": "Include new-launch project cards alongside individual listings. Project rows have recordType 'project'.", "default": true }, "includeDetails": { "title": "Include detail-page enrichment", "type": "boolean", "description": "Fetch each property's detail page for RERA numbers, amenity labels, carpet area, floor, furnishing details, and coordinates. Off by default because it adds one residential request per property.", "default": false }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Optional 99acres search URLs: /property-in--ffid?... or /-bhk-flats-in--ffid?... When provided, city and filter fields are ignored.", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of property and project records to return.", "default": 50 } } }, "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 } } } } } } } } } }