{ "openapi": "3.0.1", "info": { "title": "99acres Scraper | Fast & Reliable | $3.5 / 1k", "description": "Scrapes detailed real estate listings from 99acres.com, India's leading property portal. Extracts prices, location details, agent/dealer info, and property specs. Fast and reliable, it delivers clean, structured data ready for market analysis, lead generation, and competitor research.", "version": "0.1", "x-build-id": "e5dxyNRxaXQfa22Yw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~99acres-scraper-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-99acres-scraper-ppe", "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~99acres-scraper-ppe/runs": { "post": { "operationId": "runs-sync-fatihtahta-99acres-scraper-ppe", "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~99acres-scraper-ppe/run-sync": { "post": { "operationId": "run-sync-fatihtahta-99acres-scraper-ppe", "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": [ "location", "deal_type" ], "properties": { "location": { "title": "Add Location Names", "type": "array", "description": "Enter one or more Indian locations, such as New Delhi, Mumbai, Gurgaon, or Western Mumbai. Broader locations discover more listings; narrower localities produce more targeted datasets.", "items": { "type": "string" } }, "deal_type": { "title": "Choose Listing Segment", "enum": [ "residential_sale", "residential_rent", "commercial_sale", "commercial_rent" ], "type": "string", "description": "Choose the transaction type and property market you want to collect. Pick the segment that matches your analysis, lead sourcing, pricing study, or competitive monitoring workflow." }, "min_price": { "title": "Set Minimum Sale Price", "enum": [ "inr_0", "inr_5_lacs", "inr_10_lacs", "inr_15_lacs", "inr_20_lacs", "inr_25_lacs", "inr_30_lacs", "inr_35_lacs", "inr_40_lacs", "inr_45_lacs", "inr_50_lacs", "inr_55_lacs", "inr_60_lacs", "inr_65_lacs", "inr_70_lacs", "inr_75_lacs", "inr_80_lacs", "inr_85_lacs", "inr_90_lacs", "inr_95_lacs", "inr_1_crore", "inr_1_05_crores", "inr_1_1_crores", "inr_1_15_crores", "inr_1_2_crores", "inr_1_25_crores", "inr_1_3_crores", "inr_1_35_crores", "inr_1_4_crores", "inr_1_45_crores", "inr_1_5_crores", "inr_1_55_crores", "inr_1_6_crores", "inr_1_65_crores", "inr_1_7_crores", "inr_1_75_crores", "inr_1_8_crores", "inr_1_85_crores", "inr_1_9_crores", "inr_2_crores", "inr_2_1_crores", "inr_2_2_crores", "inr_2_3_crores", "inr_2_4_crores", "inr_2_5_crores", "inr_2_6_crores", "inr_2_7_crores", "inr_2_8_crores", "inr_2_9_crores", "inr_3_crores", "inr_3_1_crores", "inr_3_2_crores", "inr_3_3_crores", "inr_3_4_crores", "inr_3_5_crores", "inr_3_6_crores", "inr_3_7_crores", "inr_3_8_crores", "inr_3_9_crores", "inr_4_crores", "inr_4_1_crores", "inr_4_2_crores", "inr_4_3_crores", "inr_4_4_crores", "inr_4_5_crores", "inr_4_6_crores", "inr_4_7_crores", "inr_4_8_crores", "inr_4_9_crores", "inr_5_crores", "inr_5_25_crores", "inr_5_5_crores", "inr_5_75_crores", "inr_6_crores", "inr_6_25_crores", "inr_6_5_crores", "inr_6_75_crores", "inr_7_crores", "inr_7_25_crores", "inr_7_5_crores", "inr_7_75_crores", "inr_8_crores", "inr_8_25_crores", "inr_8_5_crores", "inr_8_75_crores", "inr_9_crores", "inr_9_25_crores", "inr_9_5_crores", "inr_9_75_crores", "inr_10_crores", "inr_20_crores", "inr_30_crores", "inr_40_crores", "inr_50_crores", "inr_60_crores", "inr_70_crores", "inr_80_crores", "inr_90_crores", "inr_100_crores", "inr_100_plus_crores" ], "type": "string", "description": "Select the lowest sale price to include. This field is intended for sale deal types and helps remove listings below your target purchase budget." }, "max_price": { "title": "Set Maximum Sale Price", "enum": [ "inr_0", "inr_5_lacs", "inr_10_lacs", "inr_15_lacs", "inr_20_lacs", "inr_25_lacs", "inr_30_lacs", "inr_35_lacs", "inr_40_lacs", "inr_45_lacs", "inr_50_lacs", "inr_55_lacs", "inr_60_lacs", "inr_65_lacs", "inr_70_lacs", "inr_75_lacs", "inr_80_lacs", "inr_85_lacs", "inr_90_lacs", "inr_95_lacs", "inr_1_crore", "inr_1_05_crores", "inr_1_1_crores", "inr_1_15_crores", "inr_1_2_crores", "inr_1_25_crores", "inr_1_3_crores", "inr_1_35_crores", "inr_1_4_crores", "inr_1_45_crores", "inr_1_5_crores", "inr_1_55_crores", "inr_1_6_crores", "inr_1_65_crores", "inr_1_7_crores", "inr_1_75_crores", "inr_1_8_crores", "inr_1_85_crores", "inr_1_9_crores", "inr_2_crores", "inr_2_1_crores", "inr_2_2_crores", "inr_2_3_crores", "inr_2_4_crores", "inr_2_5_crores", "inr_2_6_crores", "inr_2_7_crores", "inr_2_8_crores", "inr_2_9_crores", "inr_3_crores", "inr_3_1_crores", "inr_3_2_crores", "inr_3_3_crores", "inr_3_4_crores", "inr_3_5_crores", "inr_3_6_crores", "inr_3_7_crores", "inr_3_8_crores", "inr_3_9_crores", "inr_4_crores", "inr_4_1_crores", "inr_4_2_crores", "inr_4_3_crores", "inr_4_4_crores", "inr_4_5_crores", "inr_4_6_crores", "inr_4_7_crores", "inr_4_8_crores", "inr_4_9_crores", "inr_5_crores", "inr_5_25_crores", "inr_5_5_crores", "inr_5_75_crores", "inr_6_crores", "inr_6_25_crores", "inr_6_5_crores", "inr_6_75_crores", "inr_7_crores", "inr_7_25_crores", "inr_7_5_crores", "inr_7_75_crores", "inr_8_crores", "inr_8_25_crores", "inr_8_5_crores", "inr_8_75_crores", "inr_9_crores", "inr_9_25_crores", "inr_9_5_crores", "inr_9_75_crores", "inr_10_crores", "inr_20_crores", "inr_30_crores", "inr_40_crores", "inr_50_crores", "inr_60_crores", "inr_70_crores", "inr_80_crores", "inr_90_crores", "inr_100_crores", "inr_100_plus_crores" ], "type": "string", "description": "Select the highest sale price to include. Use it with the minimum sale price when you need a defined purchase budget range." }, "min_rent": { "title": "Set Minimum Monthly Rent", "enum": [ "inr_1000", "inr_2000", "inr_3000", "inr_4000", "inr_5000", "inr_6000", "inr_7000", "inr_8000", "inr_9000", "inr_10000", "inr_11000", "inr_12000", "inr_13000", "inr_14000", "inr_15000", "inr_16000", "inr_17000", "inr_18000", "inr_19000", "inr_20000", "inr_21000", "inr_22000", "inr_23000", "inr_24000", "inr_25000", "inr_26000", "inr_27000", "inr_28000", "inr_29000", "inr_30000", "inr_35000", "inr_40000", "inr_45000", "inr_50000", "inr_55000", "inr_60000", "inr_65000", "inr_70000", "inr_75000", "inr_80000", "inr_85000", "inr_90000", "inr_95000", "inr_1_lac", "inr_1_1_lacs", "inr_1_2_lacs", "inr_1_3_lacs", "inr_1_4_lacs", "inr_1_5_lacs", "inr_1_6_lacs", "inr_1_7_lacs", "inr_1_8_lacs", "inr_1_9_lacs", "inr_2_lacs", "inr_2_25_lacs", "inr_2_5_lacs", "inr_2_75_lacs", "inr_3_lacs", "inr_3_25_lacs", "inr_3_5_lacs", "inr_3_75_lacs", "inr_4_lacs", "inr_4_25_lacs", "inr_4_5_lacs", "inr_4_75_lacs", "inr_5_lacs", "inr_6_lacs", "inr_7_lacs", "inr_8_lacs", "inr_9_lacs", "inr_10_lac", "inr_10_plus_lac" ], "type": "string", "description": "Select the lowest monthly rent to include. This field is intended for rental deal types and helps focus the dataset on your target rental band." }, "max_rent": { "title": "Set Maximum Monthly Rent", "enum": [ "inr_1000", "inr_2000", "inr_3000", "inr_4000", "inr_5000", "inr_6000", "inr_7000", "inr_8000", "inr_9000", "inr_10000", "inr_11000", "inr_12000", "inr_13000", "inr_14000", "inr_15000", "inr_16000", "inr_17000", "inr_18000", "inr_19000", "inr_20000", "inr_21000", "inr_22000", "inr_23000", "inr_24000", "inr_25000", "inr_26000", "inr_27000", "inr_28000", "inr_29000", "inr_30000", "inr_35000", "inr_40000", "inr_45000", "inr_50000", "inr_55000", "inr_60000", "inr_65000", "inr_70000", "inr_75000", "inr_80000", "inr_85000", "inr_90000", "inr_95000", "inr_1_lac", "inr_1_1_lacs", "inr_1_2_lacs", "inr_1_3_lacs", "inr_1_4_lacs", "inr_1_5_lacs", "inr_1_6_lacs", "inr_1_7_lacs", "inr_1_8_lacs", "inr_1_9_lacs", "inr_2_lacs", "inr_2_25_lacs", "inr_2_5_lacs", "inr_2_75_lacs", "inr_3_lacs", "inr_3_25_lacs", "inr_3_5_lacs", "inr_3_75_lacs", "inr_4_lacs", "inr_4_25_lacs", "inr_4_5_lacs", "inr_4_75_lacs", "inr_5_lacs", "inr_6_lacs", "inr_7_lacs", "inr_8_lacs", "inr_9_lacs", "inr_10_lac", "inr_10_plus_lac" ], "type": "string", "description": "Select the highest monthly rent to include. Use it with the minimum rent when you need a defined rental budget range." }, "verified_property": { "title": "Include Only Verified Properties", "type": "boolean", "description": "Turn this on to collect only listings marked as verified on 99acres. Keep it off to include both verified and unverified listings for broader discovery.", "default": false }, "rera_approval": { "title": "Choose RERA Signals", "type": "array", "description": "Choose RERA-approved properties, RERA-registered dealers, or both when compliance-related signals are important to your review process.", "items": { "type": "string", "enum": [ "approved_property", "approved_agent" ], "enumTitles": [ "RERA Approved Properties | property signal", "RERA Registered Dealers | dealer signal" ] } }, "property_type": { "title": "Choose Property Categories", "type": "array", "description": "Select the property categories to include, such as apartments, villas, shops, offices, warehouses, or land. Selecting more categories broadens the dataset; selecting fewer categories makes the output easier to compare.", "items": { "type": "string", "enum": [ "all_residential", "all_commercial", "apartment", "house_villa", "land", "builder_floor", "farm_house", "shop", "office_space", "land_institutional_land", "mall_space_retail", "office_in_business_park", "office_in_it_park", "warehouse", "industrial_land", "factory", "agricultural_farm_land", "business_center", "serviced_apartment", "showroom", "one_rk_studio_apartment" ], "enumTitles": [ "All Residential | all home types", "All Commercial | all business property types", "Apartment | flat or apartment", "House/Villa | independent home or villa", "Land | residential plot or land", "Builder Floor | independent floor", "Farm House | farmhouse property", "Shop | retail shop", "Office Space | office property", "Institutional Land | institutional plot", "Mall Space - Retail | mall retail unit", "Office in Business Park | business park office", "Office in IT Park | IT park office", "Warehouse | storage or logistics property", "Industrial Land | industrial plot", "Factory | factory property", "Agricultural/Farm Land | agricultural land", "Business Center | managed business space", "Serviced Apartment | serviced residence", "Showroom | display or retail showroom", "1 RK / Studio Apartment | compact home" ] } }, "min_area": { "title": "Set Minimum Built-Up Area", "minimum": 1, "type": "integer", "description": "Enter the smallest built-up area, in square feet, that a listing should have to be included. Leave empty when size is not part of your selection criteria." }, "max_area": { "title": "Set Maximum Built-Up Area", "minimum": 1, "type": "integer", "description": "Enter the largest built-up area, in square feet, that a listing should have to be included. Use it with the minimum area to define a clear size range." }, "bedroom_count": { "title": "Choose Bedroom Counts", "type": "array", "description": "Select one or more BHK options, such as 1 BHK, 2 BHK, or 3 BHK. This filter is most useful when comparing residential homes by layout.", "items": { "type": "string", "enum": [ "any_bhk", "one_bhk", "two_bhk", "three_bhk", "four_bhk", "five_bhk", "six_bhk", "seven_bhk", "eight_bhk", "nine_bhk", "ten_bhk" ], "enumTitles": [ "Any BHK", "1 BHK", "2 BHK", "3 BHK", "4 BHK", "5 BHK", "6 BHK", "7 BHK", "8 BHK", "9 BHK", "10 BHK" ] } }, "contruction_status": { "title": "Choose Construction Stage", "type": "array", "description": "Select the construction stages to include, such as new launch, under construction, or ready to move. Use this when project readiness affects your shortlist.", "items": { "type": "string", "enum": [ "new_launch", "under_construction", "ready_to_move" ], "enumTitles": [ "New Launch | newly released projects", "Under Construction | in-progress projects", "Ready to Move | available properties" ] } }, "seller_type": { "title": "Choose Seller Sources", "type": "array", "description": "Select whether to include listings from owners, builders, dealers, featured dealers, or a combination of seller sources.", "items": { "type": "string", "enum": [ "owner", "builder", "dealer", "featured_dealer" ], "enumTitles": [ "Owner | direct seller", "Builder | developer listing", "Dealer | broker listing", "Featured Dealer | promoted broker listing" ] } }, "purchase_type": { "title": "Choose Purchase Types", "type": "array", "description": "Select resale, new booking, or both to control which sale listing categories are collected. This is most relevant for purchase-focused sale searches.", "items": { "type": "string", "enum": [ "resale", "new_booking" ], "enumTitles": [ "Resale | existing property", "New Booking | new project booking" ] } }, "furnishment": { "title": "Choose Furnishing Levels", "type": "array", "description": "Select unfurnished, semifurnished, furnished, or multiple options to match the move-in condition your workflow requires.", "items": { "type": "string", "enum": [ "unfurnished", "semifurnished", "furnished" ], "enumTitles": [ "Unfurnished | no furnishing", "Semifurnished | partial furnishing", "Furnished | ready furnished" ] } }, "with_photo": { "title": "Include Only Listings with Photos", "type": "boolean", "description": "Turn this on to collect only listings that include photos. Keep it off when you want the broadest set of matching listings.", "default": false }, "with_video": { "title": "Include Only Listings with Videos", "type": "boolean", "description": "Turn this on to collect only listings that include videos. Keep it off when video availability is not required for your workflow.", "default": false }, "limit": { "title": "Set Listings to Save", "minimum": 1, "type": "integer", "description": "Enter the maximum number of listings to save for each location. If left empty, the actor saves up to 100 listings per location.", "default": 100 } } }, "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 } } } } } } } } } }