{
  "openapi": "3.0.1",
  "info": {
    "title": "99acres Scraper — Property Listings, Prices & Dealers",
    "description": "99acres scraper: export flats, houses, plots and offices for sale or rent from any Indian city with price, price per sqft, BHK, carpet and super area, locality, GPS, builder, owner or dealer name, posted date, amenities and photos. Filters for BHK, type, budget and poster. No login.",
    "version": "1.0",
    "x-build-id": "1CZgeez5d3Hri3UJW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/logiover~99acres-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-logiover-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/logiover~99acres-scraper/runs": {
      "post": {
        "operationId": "runs-sync-logiover-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/logiover~99acres-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-logiover-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": {
          "locations": {
            "title": "Cities or localities",
            "type": "array",
            "description": "Cities such as Mumbai, Delhi, Bangalore, Hyderabad, Pune, Chennai, Gurgaon, Noida, Kolkata, Ahmedabad, Thane, Navi Mumbai — or any locality: \"Bandra West, Mumbai\", \"Whitefield Bangalore\", \"Sector 150 Noida\". Several entries share the row limit fairly.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Free-text searches (optional)",
            "type": "array",
            "description": "Search phrases exactly as you would type them on 99acres, e.g. \"3 bhk flats for rent in Andheri West Mumbai\", \"plots for sale in Gurgaon\", \"commercial office space for rent in Pune\". Place, sale/rent, BHK and property type are understood from the text.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "99acres search URLs (optional)",
            "type": "array",
            "description": "Paste 99acres search-result pages (the ones ending in -ffid, e.g. https://www.99acres.com/property-in-bandra-west-western-mumbai-ffid). The place and filters in the URL are used. Single property pages are not needed: every detail is already in the search data.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "listingType": {
            "title": "Buy or rent",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Properties for sale or for rent. Applies to cities and localities you list above (free-text searches can say it themselves).",
            "default": "sale"
          },
          "propertyCategory": {
            "title": "Residential or commercial",
            "enum": [
              "residential",
              "commercial"
            ],
            "type": "string",
            "description": "Homes, plots and flats, or offices, shops, warehouses and other commercial space.",
            "default": "residential"
          },
          "bedrooms": {
            "title": "Bedrooms (BHK)",
            "type": "array",
            "description": "Only these bedroom counts. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6+"
              ],
              "enumTitles": [
                "1 BHK",
                "2 BHK",
                "3 BHK",
                "4 BHK",
                "5 BHK",
                "6 or more"
              ]
            }
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Only these kinds of property. Leave empty for all types of the chosen category.",
            "items": {
              "type": "string",
              "enum": [
                "apartment",
                "villa",
                "plot",
                "builder-floor",
                "studio",
                "farmhouse",
                "serviced-apartment",
                "office",
                "shop",
                "warehouse",
                "factory",
                "commercial-land"
              ],
              "enumTitles": [
                "Apartment / Flat",
                "Independent house / Villa",
                "Residential plot / Land",
                "Builder floor",
                "Studio apartment",
                "Farm house",
                "Serviced apartment",
                "Office space (ready, bare shell, co-working)",
                "Shop / Showroom / Retail",
                "Warehouse",
                "Factory / Manufacturing",
                "Commercial / Industrial / Agricultural land"
              ]
            }
          },
          "postedBy": {
            "title": "Posted by",
            "type": "array",
            "description": "Owner listings (no broker), dealer listings or builder listings. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "owner",
                "dealer",
                "builder"
              ],
              "enumTitles": [
                "Owner",
                "Dealer / agent",
                "Builder"
              ]
            }
          },
          "furnishing": {
            "title": "Furnishing",
            "type": "array",
            "description": "Only these furnishing levels. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "furnished",
                "semi-furnished",
                "unfurnished"
              ],
              "enumTitles": [
                "Furnished",
                "Semi-furnished",
                "Unfurnished"
              ]
            }
          },
          "minPrice": {
            "title": "Minimum price (INR)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price in rupees (monthly rent for rentals). Applied while reading, so the Actor may fetch more pages than it saves."
          },
          "maxPrice": {
            "title": "Maximum price (INR)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price in rupees (monthly rent for rentals). Applied while reading."
          },
          "verifiedOnly": {
            "title": "Verified listings only",
            "type": "boolean",
            "description": "Only listings 99acres marks as verified.",
            "default": false
          },
          "includeProjects": {
            "title": "Include new projects",
            "type": "boolean",
            "description": "99acres mixes builder projects (new launches with several unit types) into its results. They are saved as recordType \"project\". Switch off to get individual listings only. Projects are dropped automatically when you filter by BHK, type, poster, furnishing or verification.",
            "default": true
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "newest",
              "priceLow",
              "priceHigh"
            ],
            "type": "string",
            "description": "Newest first is the stable order and the only one that lets the Actor read a whole city.",
            "default": "newest"
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many records (across all searches). You are charged per record saved.",
            "default": 1000
          },
          "maxItemsPerSearch": {
            "title": "Maximum results per search",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Optional limit for each city / phrase, so one big city cannot use the whole budget. 0 or empty = no limit."
          },
          "maxConcurrency": {
            "title": "Parallel sessions",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Parallel sessions, each with its own IP address (99acres answers four requests per address). 16 reads about 1,000 listings in 20-30 seconds.",
            "default": 16
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Leave the default: the Actor uses residential proxies by itself because 99acres blocks datacenter addresses after four requests each. Residential traffic is about 2 KB per listing.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}